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tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, anew standard of excellence! * 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original 1 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov 

ax,2517h 




int 

21 h 

; DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
; (’Halt when ? printed.’) 

mov 

dx,offset data 4 

mov 

ini 

ah ,9 

21 h 

: DOS Services ah=function 09h 

; display char string at ds:dx 

mov 

dx,19h 



ah,31h 


int 

; DOS Services ah=function 31 h 


; terminate and stay resident 
; akreturn code,dx=paragraphs 


virustst endp 




intJ7h_entry proc 
pushf 

far 

; Push flags 

emp 

al,3Fh 
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From the Editor 


Hey, we really are making progress — I had no idea that the draft ANSI C++ standard is on the Web. 
Thanks to reader Bob Griffith for pointing it out to me: http: //www. cygnus. com/tni sc/wp/draft. AT My 
thanks to Charles Cowden for sending me a little incentive in the mail; your letter is posted in front of 
me and has inspired me to go after more articles like the one you liked. AT We printed an incorrect 
email address for Dan Shappir in his article in the April issue. His correct address is: 
shappir@math.tau.ac.il . AT The April issue also claimed that the address for publishers to ship 
books to would appear with every Books in Brief column. Alas, that wasn't true in the April 
issue, but it's true now (fortunately, publishers never expect programmers to deliver anything 
on time). AT If you haven't seen DEC'S Alta Vista search engine yet, give it a try at 
http://www.altavista.digital.com/. It's main problem is that it's just too dam good — I mean, this 
stuff has indexes to Usenet postings that are ten years old. I thought I would cleverly look for a ser¬ 
vice that lets me create my own HTML stuff by searching for the highly specific phrase "your own 
home page". The result was more than 10,000 hits. Kinda shows what's happening out there, huh? 
AT In the How Misleading Can I Be? department, my April column apparently (and unintentionally) 
led people to believe that Microsoft will buy free magazine subscriptions for anybody. What I was 
trying to say is that Microsoft employees (not the world at large) can just fill out an email form to get 
the company to pay for a subscription. That blurb was part of my new mission to find some nice 
things to say about Microsoft; I'm a little low on ideas now, so send me yours! AT Borland C++ v5.0 is 
out, which means you'll have to upgrade your BoundsChecker or watch it lock up your system. The 
upgrade is supposed to be out by the time you read this. AT Have you seen this deal where you can 
go to your local movie theater and watch Bill Gates giving a talk at the TECH*ED conference? Geez, 

I hope these things are rated 'R' — we don't want a bunch of traumatized little kids! AT Wanted: 
articles on Windows 95 archaeology. What I mean by this is that all these new areas of the Windows 
API have nasty, undocumented and poorly documented areas, and I'm looking for articles that sim¬ 
ply reveal the documentation mistakes and omissions in individual areas. For example, I wanted to 
use the treeview control recently, and discovered no end of obfuscation (e.g., you cannot figure out 
how to correctly send a TVM_GETITEMRECT message without mounting an expedition into wi ndowsx. h). 
AT We're going to have a go at interjecting some concrete measurements into the always popular sub¬ 
ject of "whose Windows compiler is best?" Are the compiler vendors right that you care mostly about 
new IDE features and not about things like how well written their runtime library is, how good the 
code generated is, and how many new bugs the latest version introduces? Read the first installment of 
our benchmark series and tell us what you would like to see benchmarked, critique our existing 
benchmarks, or help us create new ones. The level of reader interest and involvement will determine 
how far this series goes. AT We stopped giving out free t-shirts because I was getting swamped by the 
avalanche of new annotations that the Windows 95 documentation generated. However, now I am 
happy to say we have V. Ramachandran handling our annotation stream, and he can tackle MFC 
annotations as well as Win32 annotations. Please take the time to note that documentation snafu and 
email it to 70302.2566@compuserve. com; we'll make sure you get credited as the submitter, and we'll all 
have a bigger database of documentation corrections to save us time. AT If you can't send us an SDK 
annotation, how about sending us a C/C++ compiler bug? I've amazed myself recently by finding the 
time to start a little database of all the bugs we get that I can manage to verify. One reason I've been 
succeeding with this is because most readers do an excellent job of cooking the the problem down to 
the smallest possible example; I can often verify it to my satisfaction in 20 minutes or so. Anyway, 
please keep sending them in and we will find an outlet to expose all we can, even the ones that don't 
make it into the Bug++ column. AT Does anybody out there really use that new "Windows 95" key? 
On my Gateway keyboard, it's stuck between the Ctrl and Alt keys and the only time I ever hit it is by 
accident, which takes the focus away from my current app. Then I have to hit the Esc key to get rid of 
the Start menu (hitting the Win95 key again does nothing). At that point, I don't know who has the 
focus, but it sure isn't my original app, so I have to reach for the mouse to select it again. Still, I'm 
grateful — how much more awful would it have turned out if Microsoft didn't have that million-dol- 
lar usability test lab? AT An ad for MS/'s Web site says they're one of the first magazines to introduce 
an interactive medium to "compliment" the printed version. Thus inspired, I'm starting my own Web 
page just to compliment me. So far I've got "He's kind to animals." and "He's rarely disrespectful to 
your face." but other than that I'm a little short. Send your compliments to the address below. 

Ron Burk 




Editor 

70302.2566@compuserve.com 


Drop in on our Web site! 
You’ll find us at: 

http ://www. wd j .com 


You’ll find information and excerpts from 
the current issue, along with links to WDJ 
code, including our SDK Annotations. 
Check it out — and let us know what you 
think. 
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OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 
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• And many more 

Interfaces* 
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• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLL’s 

• C/C++ 

• OCX’s 

• Access 

• VBX’s 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 



u 408.366.8933 
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Compiler Benchmarks: 
new/delete 

Ron Burk 


;E3= 

Borland C++ v5.0 
Symantec C++ v7.2 

Visual C++ v4.1 


Watcom C++ vl 0.5 


Visual Age C++ v3.5 


Which Windows C/C++ compiler is best? That question gets asked a lot, both by 
programmers new to the market and by programmers wondering if their current com¬ 
piler is the best choice. My answer to this question is always "the best compiler for 
what purpose?" Windows compiler packages are so complex, and are used for so 
many different kinds of tasks, it's just not reasonable to expect that one would be the 
best choice for all situations. That makes compiler reviews problematic — how can 
you compare such highly complex and technical products with any degree of mean¬ 
ingfulness? This dilemma has prevented us from writing compiler reviews in the past. 

On the other hand, someone once said that for every quantity that is difficult to 
measure, there is some measurement that is better than nothing. That sort of think¬ 
ing kept nagging me to do some form of comparative compiler coverage, and this 
article is the first installment in a series. The series will attempt to benchmark very 
specific areas of 32-bit Windows compilers, covering Microsoft's Visual C++, 
Borland C/C++, Symantec C++, Watcom C++, and IBM's Visual Age C++ for 
Windows. Even if you have no intention of switching compilers, you might find this 
series useful because it documents some relative strengths and weaknesses of each 
compiler. For example, in this first installment, you will learn that one popular com¬ 
piler package is poorly suited for a specific class of applications. 

What's in a Benchmark? 

Creating benchmarks is easy, but creating good benchmarks is hard. One problem 
is that it can be difficult to measure what you think you're measuring. When mea¬ 
suring speed, for example, you must try to eliminate extraneous factors such as 
background disk activity or even the effects of the CPU instruction cache. The bench¬ 
marks in this series won't be perfect, but since each vendor has the opportunity to 
see them before publication, they receive at least one technical review. I also expect 
readers to point out flaws or useful enhancements, so if the series proves popular, we 
can improve the benchmarks iteratively over time. 

Another problem with benchmarks is the danger that people will extrapolate incor¬ 
rect information from the benchmark results. For example, this first benchmark shows 
that (in a particular scenario) a particular compiler provides faster memory allocation 
than the other compilers. Does that mean that compiler provides the "best" memory 
management? No, because the benchmark does not measure other dimensions, such 
as how much space overhead each allocation requires, or even whether or not the com¬ 
piler frees up memory when requested! It is possible to build a very bad memory man¬ 
agement package that scored very well on this particular benchmark. Still, if you avoid 


Ron Burk is the editor of Windows Developer's Journal. You may contact him at 
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Listing 1 membench.cpp — Memory 
management benchmark code 


//include <assert.h> 

//include <windows.h> 

//include <stdio.h> 

//include <stdlib.h> 

//include <time.h> 

//define CPS ((int)CLOCKS_PER_SEC) 

long NIterations; 

int NBlocks; /* total number of memory blocks to allocate */ 

int MinBlockSize; /* minimum block size to allocate */ 

int MaxBlockSize; /* maximum block size to allocate */ 

int DummyCount; // so no one can optimize my dummies away 
void Dummy Free(void* Foo); 

void* DummyMa11oc(size_t Size); 

void BenchMark(void) 

{ 

clock_t StartTime, StopTime, LoopTime, TotalTime; 

long i; 
void** Pointers; 
int* Sizes; 

/* first, create array of pointers */ 

Pointers = (void**)calloc(NBlocks, sizeof(void*)); 

Sizes = (int*)calloc(NBlocks, sizeof(int)); 

/* second, initialize sizes to random values */ 
for(i-0; i < NBlocks; ++1) 

{ 

int Size - randO % ((MaxBlockSize-MinBlockSize) + 1); 

Size +- MinBlockSize; 

Sizes[i] - Size; 

} 

/* third, measure basic loop time */ 

StartTime - clockO; 

for(i - 0; i < NIterations; ++i) 


all extrapolation and examine only the very narrow results of 
the benchmark, useful information is usually available. 

For this first benchmark, I decided to measure something 
that is technically part of the runtime library, not the actual 
compiler: memory management speed. Most programs make 
at least some use of the runtime library memory management 
functions, and many rely on them extensively. However, most 
programmers don't know a lot about how or how well their 
compiler vendor implements these standard functions. 
Usually it doesn't matter, but sometimes it can make a big dif¬ 
ference, as this benchmark will show. 

The Benchmark Design 

The benchmark's source is in metTlbench. cpp (Listing 1). My 
goal was to measure the basic speed of the new and del ete C++ 
operators. For those of you who aren't familiar with C++, new 
and del ete are basically typesafe wrappers for mal 1 oc( ) and 
freed. I tried to keep the benchmark extremely simple in 
order to make it easy to understand. I also wanted to be able to 
readily verify its validity. The program basically sits in a loop 
and randomly creates and deletes memory blocks of a random 
size (up to a maximum block size). You can control the maxi¬ 
mum number of blocks and the maximum block size via com¬ 
mand-line parameters. 

For each of the five compilers, I compiled this program 
with the default compiler options to produce a 32-bit 
Windows console application. I then ran this program under 
Windows 95 on a 133Mhz Pentium with 32Mb of physical 
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This Is Your App... 




This Is Your App with MapObjects... 
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memory. For each compiler, the benchmark was run with the 
following settings: 

membench 1000 32 
membench 1000 64 
membench 1000 128 
membench 1000 256 


small blocks, whereas programs often create many small 
objects and relatively fewer large objects. I think Borland is 
right, but I also think that there are several different patterns 
of memory usage that programs might fall into, so I decided to 
keep this benchmark as simple as possible. If your compiler 
package is noticeably slow with this simple benchmark, it is 


In other words, the benchmark used a maximum of 1,000 allo¬ 
cated blocks of memory, with a maximum block size ranging 
from 32 bytes to 256 bytes. I was guessing that a moderately 
memory-intensive program might use around 1,000 strings, 
C++ objects, etc., and I wanted to see how speed varied with 
respect to the average size of memory blocks. I ran the bench¬ 
mark with each of these settings three times for each compiler 
and kept the smallest number (rounded to the nearest hun¬ 
dredth of a second). Running them three times gave me confi¬ 
dence that the numbers were quite reproducible and that stray 
effects (such as having to swap out other programs to make 
room for a memory allocation) were not interfering. 

One flaw with this benchmark is that it produces absolute 
numbers that depend on the speed of the machine executing 
the code. It would be much better if the benchmark resulted in 
a ratio that could be reliably reproduced on any type or speed 
of PC. However, I simply couldn't come up with an algorithm 
that produced such a stable ratio. If anyone has ideas to solve 
this problem, let me know. 

Borland noted another flaw after they reviewed the bench¬ 
mark — the benchmark is equally likely to allocate large and 
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Listing 1 continued 


t 

int iBlock - i % NBlocks; 

if(Sizes[iBlock]&l) // randomly call dummy free or malloc 
{ 

DummyFree(Pointers[iBlock]); 

Pointers[iB1ock] - 0; 

} 

else 

Pointers[iB1ock] = DummyMal1oc(Sizes[iBlock]); 

} 

StopTime - clockO; 

LoopTime = StopTime - StartTime; 

/* fourth, allocate a random set of blocks */ 
for(i—0; i < NBlocks; ++i) 
if(rand() & 1) 

Pointers[i] - new char[Sizes[i]]; 


/* finally, perform benchmark */ 

StartTime - clockO; 

for(i - 0; i < NIterations; ++i) 

{ 

int iBlock - i % NBlocks; 
if(Pointers[iBlock]) 

{ 

delete[] Pointers[iBlock]; 

Pointers[iB1ock] - 0; 

} 

else 

Pointers[iBlock] - new char[Sizes[iB1ock]]; 

} 

StopTime - clockO; 

TotalTime - (StopTime - StartTime) - LoopTime; 

printf("NIterations-%1d, NB1ocks-%d, MinBlockSize-%d. MaxBlockSize-%d\n", 
NIterations. NBlocks, Mi nBlockSize, MaxBlockSize); 

{ 

int Secs - TotalTime / CPS; 

int Decs - (TotalTime-(Secs*CPS)) / (CPS/10); 

printf( "Time - %d.%d\n", Secs, Decs); 

printf( "memory time-%1d. loop time-%ld\n", TotalTime, LoopTime); 

} 

} 

void main(int argc, char**argv) 

{ 

// assume at least hundredths of a second resolution 
assert(CPS >- 100); 

MinBlockSize - 4; 

NIterations = 1000L*1000L*5; 

if(argc — 3) 

{ 

NBlocks — atoi(argv[l]); 

MaxBlockSize — atoi(a rgv[2]); 

} 

if(NBlocks < 1 || MaxBlockSize < MinBlockSize) 

fprintf(stderr, "Usage: membench <#of blocks) <max block size>\n"); 

else 

BenchMarkO; 

exit(DummyCount?EXIT_SUCCESS:EXIT_FAILURE); 

} 

// the runtime library will be compared against these 
// dummy functions, which represent absolute fastest 
// that memory management could be (they do nothing) 
void DummyFree(void* /*Foo*/) 

{ 

++DummyCount; 

} 

void* DummyMal1oc(size_t /*Size*/) 

{ 

-H-DummyCount; 
return 0; 

} 

//End of File 
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likely to be slow no matter what your pattern of memory 
usage is. 

Analyzing the Results 

The results of the benchmark are shown graphically in 
Figure 1. The fastest (as well as the least sensitive to block size) 
was Symantec C++. Symantec was followed, in order, by 
Watcom, Borland, IBM, and then Microsoft. The most obvious 
fact that jumps out of Figure 1 is that Microsoft's Visual C++ 
memory management is slow — terribly slow. It is more than 
four times slower than the fastest compiler, and twice as slow 
as the next most slothful competitor. The benchmark says 


new/delete speed 



Figure 1 Memory management speed 


nothing about why Visual C++ is slow, but a peek at the 
source suggests it is because their new and delete are just 
wrappers for the operating system memory heap manage¬ 
ment functions — a technique almost guaranteed to be slower 
than any reasonable hand-coded heap manager. 

This result alone was worth the effort of doing the bench¬ 
mark. For many programs that use memory casually, it really 
doesn't matter how slow the runtime library is. However, some 
applications (e.g., C++ programs that use small objects exten¬ 
sively) make fairly intense use of memory, allocating and freeing 
hundreds or thousands of blocks of memory repeatedly. If yours 
is such an application, and you currently use Visual C++, you 
may want to consider some options: switch compilers, purchase 
a fast third-party replacement for Microsoft's memory manager, 
or write your own custom memory manager. A memory man¬ 
ager that is 30 percent slower than the norm might well not be 
worth your attention, but one that is 400 percent slower than the 
norm could have a significant impact on your application. 

Another Measure 

As I mentioned before, it's easy to extrapolate incorrectly 
from a benchmark. For example, you might infer from Figure 
1 that the "best" memory manager is Symantec's, as it is both 
fast and insensitive to block size. That could be true, but it is 
not proved by the benchmark. For example, the benchmark 
does not reveal how much space overhead each memory 
block consumes, so if a compiler always allocated a minimum 
of 256 bytes for each block, it would be highly insensitive to 


With MemCheck watching over your code, 
you'll notice is that you'll spend significantly 



Don't waste any more time hunting 
down errors like overwrites, 
parameter errors, resource leaks, 
neap corruption, and strange 
crashes. MemCheck is a fast, 
automatic error detection tool that integrates 
seamlessly into your C/C++ applications. 

Your Invisible Ally 

Spend 15 minutes to link MemCheck into 
your project, then get back to work. It's that 
simple! MemCheck silently monitors your code, 
and only makes its presence known when it 
detects dangerous operations like deleting a 
selected or stock object, or using invalid handles or 
parameters. You'll get concise, informative 
messages that pinpoint what's wrong, usually 
with the exact source file and line number. 

“Gotta say this is the single BEST software 
purchase I’ve made in the last three years.” 

—Wes Peterson 

You'll be able to debug and maintain custom 
settings for up to 32 apps and DLLs simulta¬ 
neously. Detect errors in third-party libraries, 
without source code! MemCheck is royalty- 
free and doesn't require bulky debugging 
info, which makes it perfect for your remote 
testing. When you're done, just link 
MemCheck out or recompile. 




The Finest Autt 



MemLaeck 


ntime Debugger 


New! MemCheck for Windows 95 
& MemCheck for Windows NT 

MemCheck supports 32-bit development under 
Windows 95 & Windows NT! MemCheck 3.5 
for Windows now detects more errors, intercepts 
more Windows API calls, runs many times 
faster, produces a stack trace on GPFs, and 
supports both MFC and OWL. 

Error Detection for DOS, too! 

MemCheck 3.5 for DOS sports reduced size, 
blazing speed, stack checking, and more! 
Protected-mode developers using Borland's 
PowerPack or Phar Lap's 2861 DOS Extender 
will love getting a stack trace of calls leading to 
a GPF, instead of a mysterious register dump! 

At client sites, too! 

Order Today! 

We're so sure you'll love MemCheck, we can 
offer you an unconditional 60-day money-back 
guarantee. If you're not completely satisfied, you'll 
get a no questions asked, no hassles refund. 


the only difference 
less time debugging. 

Pricing and Compatibility 

MEMCHECK 3.5 FOR WINDOWS 95 . Si79 

MEMCHECK 3.5 FOR WINDOWS NT . S179 

MEMCHECK 3.5 FOR WINDOWS 16-BIT . $179 

MemCheck for Windows supports both Microsoft 7.0 thru VC+ + and 
Borland BC++ 3.x thru BC+ + 5.x. NOTE: MemCheck 3.5 for 
Windows 16-bit will not currently support Windows NT. 

MEMCHECK 3.5 FOR DOS. . S139 

For Microsoft C/C++ (6.x-8.x, VC++), Borland C/C+ + 

(BC++ 2.x-5.x), and Watcom C/C++ (9.5 and later). 

MEMCHECK 3.5 FOR EXTENDED DOS . S139 

Supports Phar Lap 286\DOS Extender (MSC, BC), Borland's 
PowerPack (DPMI 16/32), and Watcom C++ (allextenders). 

MEMCHECK FOR ANSI/K&R . SI99 

For any ANSI C/C+ + or K&R Cprojects. Hardware and OS independent. 
Includes full source code. An unbeatable value! 

Special Bundles! 

MEMCHECK WINDOWS PACK . only S297 

All threeWindows versions. Save $240! 

MEMCHECK GURU PACK . only S238 

A ny two Windo ws versions. Save $ 120! 

MEMCHECK POWER PACK . only $228 

One DOS and oneWindows version. Save $90! 

MEMCHECK MASTER PACK . only $188 

For both real- and extended-mode DOS. Save $90! 

XstratosWare Corporation 

1400>WE>DEBUG 


1756 Plymouth Road, Suite 1500 / Ann Arbor, Ml 48105-1890 • Toll-Free 1-800-WE-DEBUG • International (313) 996-2944 • Fax (313) 995+2955 & (313) 747-8519 
CompuServe 70244,1372 • Internet info@stratosware.com • World Wide Web http://www.stratosware.com/swc/ • We use and ship quality recycled materials. 


□ Request Reader Service #110 a 


Page 12 — Windows Developer’s Journal 


July 1996 



















block size, but would not be a desirable memory manager for 
most applications. I was unable to think of a benchmark that 
would accurately measure aspects of memory management 
such as the amount of per-block space overhead. However, I 
did create a simple benchmark that answers one more ques¬ 
tion about each of these compilers: do they implicitly return 
space to the operating system? 

That question requires explanation. Suppose your applica¬ 
tion at some point allocates a great many memory blocks (say 
2Mb). At that point, your application is using 2Mb worth of vir¬ 
tual addresses (no loss there, Windows gives you 2Gb) and 
2Mb worth of committed space in the swap file (a much more 
limited resource). Now suppose that your application com¬ 
pletes the operation that required so 
much memory and calls del ete or f reel) 
to free up every last memory block it 
allocated. Once the very last block is 
deallocated, how much virtual address 
space and committed swap space do you 
think your program is using? The 
answer depends entirely on how your 
memory manager is implemented. 

Most memory managers operate in a 
fashion that is at least as old as the very 
first UNIX. They initially call the operat¬ 
ing system (a relatively slow proposi¬ 
tion) to request a large chunk of memory. 

They then suballocate small chunks of 
memory as requested by new or 
mallocO; the suballocation operation 
does not require the overhead of an 
operating system call and can generally 
be fairly efficient. If there is no sub¬ 
chunk large enough to meet the current 
request, the memory manager returns 
to the operating system and requests 
another large chunk. The question is, 
when does the memory manager notice 
that one of the big chunks is completely 
free and return it to the operating sys¬ 
tem (freeing up the virtual address 
space and the committed space in the 
swap file that it occupied)? 

PC compilers basically offer two dif¬ 
ferent solutions to this problem. One 
solution is to check each time you call 
f ree() or del ete to see if the block you 
are freeing is the very last block in the 
large chunk and, if it is, to then return 
that big chunk to the operating system. 

The alternative is to supply a separate 
callable function to explicitly search for 
any large chunks that are completely 
free and that can therefore be returned 
to the operating system. 

In case you think this style of memo¬ 
ry management (allocate a bunch of 
memory, then free it all) rarely arises in 
practice, let me give one increasingly 


common example. Suppose you are implementing a program 
as an NT service, or as most any kind of server. The odds are 
good that your program waits for a request, operates on the 
request, then returns to waiting. The odds are also good that 
your program allocates memory while performing the request 
and then frees it all up again. If the amount of allocated mem¬ 
ory can vary greatly depending on the request, then you 
might want to be able to return memory to the operating sys¬ 
tem when you are no longer actively using it. Otherwise, one 
unusually big request will commit space in the swap file that 
will remain committed for the life of your application (and 
server applications can be expected to live for days and 
weeks). 
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Detecting the Behavior 

The code disk (see Table of Contents 
for availability) contains a little program 
I wrote, called nofree.cpp, that tests 
whether or not a memory manager 
implicitly returns memory to the operat¬ 
ing system. It first uses the 
VirtualAllocO family of Win32 func¬ 
tions to determine how much virtual 
address space is available. It then allo¬ 
cates several megabytes of memory in a 
linked list. Finally, it frees the entire 
linked list and remeasures the amount of 


virtual address space available. The 
results of this measurement don't 
require a table: Borland is the only com¬ 
piler that automatically returns memory 
to the operating system on your behalf. 
All the other compilers offer a function 
called _heapmin() that you can call to 
locate and free up any chunks that could 
be returned to the operating system. 

Amazingly, the Microsoft version of 
JieapminO does not actually work under 
Windows 95. The documentation indi¬ 
cates that it only works under Windows 


NT, and nofree.cpp verifies that it does 
not return memory to the operating sys¬ 
tem under Windows 95.1 was unable to 
successfully link with the Symantec ver¬ 
sion of _heapmin( ); I'm still investigating 
that problem. Watcom offers a function 
called _heapshrink() that is supposed to 
do the trick, but nofree.cpp indicates 
that it doesn't — no virtual address 
space gets freed up. This turned out to be 
a bug in Watcom C++ vl0.5. The compa¬ 
ny actually sent me version 10.6, but 
because I did not give them the correct 
address it did not arrive in time. I apolo¬ 
gize to Watcom for the mixup and will 
use 10.6 in future reviews. 

Is Borland's approach better than the 
separate function approach? It certainly 
didn't seem to slow the Borland compil¬ 
er down that much in the benchmark, so 
1 don't think one can argue that it's very 
inefficient. During vendor feedback, 
IBM indicated that they chose to use a 
separate function to avoid the pathologi¬ 
cal case in which a single block is allocat¬ 
ed and freed at a chunk boundary, caus¬ 
ing a call to allocate/free the big chunk 
repeatedly. I feel the Borland algorithm 
is the best, simply because it is the least 
likely to cause surprises for program¬ 
mers who have never considered the 
problem. However, the real point here is 
to be aware of the problem and how 
your compiler deals with it (or fails to 
deal with it!). 

Summary 

Like most benchmarks I've made, 
this one is very simple and very limited. 
Also, like most benchmarks I've made, 
this one revealed interesting and surpris¬ 
ing information. I know now not to use 
Visual C++ for memory intensive appli¬ 
cations, or when it is crucial to return 
unused memory to the operating sys¬ 
tem. I found that minimizing the heap 
does not work in Watcom vl0.5 (but is 
fixed in 10.6), and that I can't link with 
JieapminO in Symantec v7.2, though I 
still don't know why. If you don't have 
the luxury of switching compilers in 
such situations, you may want to consid¬ 
er using a third-party memory manage¬ 
ment library or writing your own. If you 
spot a flaw in the benchmark or my con¬ 
clusions, or you have ideas for enhance¬ 
ments or for new benchmarks, please 
drop me a line. Next month's bench¬ 
mark will examine a specific aspect of 
C++ code generation. □ 
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Tiny Captions for MFC Splitter 
Views 

V. Ramachandran 



One popular new style for certain types of applications is the multi-pane window. 
For example, the MSDN CD-ROM viewer provides a main window with two panes. 
The left pane displays an index tree of the CD contents, while the right pane displays 
the current topic. The active pane (the one currently responding to the mouse and key¬ 
board) is highlighted with a blue rectangle at the top — a sort of half-height caption. 
How can you accomplish the same effect in your own application? MFC can provide 
most of this interface right out of the box. MFC's CSplitterWnd class lets you create 
multiple window panes (whose boundaries the user can adjust) and to display the 
view of your choice in each pane. However, MFC does not visibly identify which view 
is currently active. In this article, I explain how to indicate the currently active view via 
non-client painting, using three obscure Windows messages. The result is a reusable 
class that allows you to derive your own splitter views with captions. 

The specifications for such a class were simple: the splitter view should have a 
pseudo caption, to be displayed in the highlighted caption color (C0L0R_ACTI V EC APT I ON) 
when the view is active, and in the normal caption color (C0L0R_INACTIVECAPTION) 
when the view is inactive. The class should achieve this with minimal changes to user 
code. Since the pseudo caption uses valuable screen space to draw itself, it should also 
be able to print a caption string in that space. 

Failed Attempts 

I first tried specifying the WS_CAPTI ON style when I created the view window. This 
did not work because the splitter views are created as child windows (with the 
WS_CHILD style bit on), and Windows does not correctly handle a window with both 
the WS_CHI LD and WS_CAPTION bits set. Moreover, it is confusing to the end user to see 
numerous captions (the MDI parent caption, the MDI child window caption, and 
captions for the individual views). 

I then attempted to paint a fake caption at the top of the pane's client area. This 
worked, but if your view allows scrolling, then the caption will also scroll away. This 
approach also required changes to the user's code. For example, if you used a form 
view as a splitter pane, then all the child control positions would have to be moved 
down to accommodate height of the fake caption in the client area. 

Next, I looked at ways I could extend the CSpl i tterWnd class by overriding virtual 
functions. Looking through the MFC source code for CSpl i tterWnd, I realized that this 
class recalculates the sizes of the splitter panes in its member function Recal cLayout(). 
Therefore, it would be a simple case of rewriting Recal dayout () after providing space 


V. Ramachandran is a consultant with Imagine Technologies, Madras, India, where he devel¬ 
ops Document Imaging and Work Flow solutions. He can be reached at 
raja@imagine.uunet. in. 
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for the pseudo caption. However, 
because Recal cLayout () is not virtual, 
any calls to this function by one of the 
CSplitterWnd member functions calls 
will be to the original RecalcLayoutO. 
One workaround was to copy the entire 
CSplitterWnd source code (altering only 
Recal cLayoutO) to create a new class 
called MySpl itterWnd. However, this was 
ugly, so I pursued yet another solution. 

Since I could not solve the problem 
by altering the MFC library, I next tried 
Windows messages. Using a combina¬ 
tion of three relatively obscure mes¬ 
sages — WMJCCALCSIZE, WMJCPAINT, and 
WMJCHITTEST — I was able to produce a 
pseudo caption without changing a line 
of MFC code. 

WM_NCCALCSIZE 

Windows sends a WM_NCCALCSIZE 
whenever it needs to calculate the size 
and position of a window's client area. 
Most programs pass this message to 
DefWi ndowProc( ), which calculates the 
client size based on whether or not the 
window has a caption, the window's 
border type, and so on. If I could trap 
this message for all the splitter views, 
return a client area consisting of the 
complete window area minus the pseu¬ 
do caption area, and position it such 
that the pseudo caption area is on the 
top, I would effectively have some non¬ 
client area remaining at the top of each 
splitter view. I could then paint the 
pseudo caption in this non-client area. 

To get the correct client area size, I 
first pass the WM_NCCALCSIZE message to 
DefWi ndowProcO. The 1 Pa ram of this 
message is a pointer to a 
NCCALCSIZE_PARAMS structure. The first 
field in this structure is an array of rec¬ 
tangles, the first of which contains the 
position and size of the window's client 
area. (The SDK documentation incor¬ 
rectly states that it contains coordinates 
of the window being moved or sized.) 
Since DefWi ndowProc( ) supplies the cor¬ 
rect client coordinates, I add the caption 
height to the position y value. 

Now that I have some non-client area 
on the top of the splitter view, I can use 
the WM_NC PA I NT message to paint on it. 

WM_NCPAINT 

The pseudo caption gets drawn in the 
WM_NCPAINT message handler. Handling 
WM_NCPAINT is similar (but not identical) 


to handling WM_PAI NT. The differences are 
in how you obtain a device context and 
which coordinate system you use. 

In the WM_PAI NT handler you need to 
get a device context (DC) for the win¬ 
dow client area, whereas in the 
WM_NCPAINT handler you need to get a 
DC for the entire window (client and 
non-client) area. While you would use 
BeginPaint to get the DC in a WM_PAI NT 
handler, you need to use GetWi ndowDC to 
get the DC in a WM_NCPAINT handler. 

When using a window DC, remem¬ 
ber not to pass client coordinates to 
functions which take the DC as a para¬ 
meter. For a window DC, the coordi¬ 
nate (0,0) is the upper left comer of the 
entire window, not the upper left corner 
of the client area. 

I ran the application after I trapped 
WMJCCALCSIZE and WMJCPAINT and 
painted the pseudo caption. It worked 
correctly except when I clicked on the 
pseudo caption of the inactive splitter 
view. I expected the view to get activat¬ 
ed when I clicked on the pseudo caption, 
but nothing happened. After a bit of 
Spying, I realized that the view was not 
receiving any mouse messages. So, I 
needed to handle the third message. 

WM_NCHITTEST 

Windows sends this message when¬ 
ever you move the mouse. Typically, 
you pass this to DefWi ndowProc(), which 
tries to determine over which portion of 
the window (caption, client area, bor¬ 
der, etc.) the mouse is positioned. The 
return value from this message tells 
Windows where you are and how to 
behave if a click occurs. The default 
window procedure checks whether or 
not the mouse is above a border and 
changes the mouse cursor accordingly. 
The default procedure also checks 
whether or not the mouse is over the 
caption. If it is, a click and drag will 
move the window. 

When Windows sent a WMJCHITTEST 
message to the splitter view, the default 
window procedure did not recognize the 
pseudo caption as part of the non-client 
area. It realized that the pseudo caption 
was not the client area (thanks to the 
WMJCCALCSIZE message handler), but 
could not identify what type of non¬ 
client area it was, and therefore returned 
HTJOWHERE. When Windows receives a 
HTJOWHERE return value from 
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Listing 1 zcapform.cpp — Source for tiny caption class 


//include "stdafx.h" 

//include "zcapform.h" 

//ifdef .DEBUG 
//undef THIS.FILE 

static char BASED.CODE THIS_FILE[] - _FILE_; 

//end if 

IMPLEMENT_DYNAMIC (ZCaptionFormView, CFormView) 

//define new DEBUG JEW 
//define LEFTJARGIN 2 

BEGIN_MESSAGE_MAP(ZCaptionFormView, CFormView) 

//{{AFX_MSG_MAP(ZCaptionFormView) 

ONJESSAGE (WMJCCALCSIZE, OnNcCalcSize) 

ON_WM_NCPAINT() 

0N_WM_NCHITTEST() 

//}}AFX_MSG_MAP 
END_MESSAGE_MAP() 

/********************************************************/ 
// OnActivateView - MFC virtual function called whenever 
// the view loses or gains activation. 

// Force repaint of caption, and then call base class. 

/ ******************************************** ************j 

void ZCaptionFormView::OnActivateView (BOOL bActivate, 
CView *pActivateView, CView *pDeactivateView) 

{ 

mJActive - bActivate; 

if ((m.nCaptionHeight > 0) && (::IsWindow (m.hWnd))) 
SendMessage (WMJCPAINT); 

CFormView::OnActivateView (bActivate, pActivateView, 
pDeactivateView); 


// OnActivateFrame - MFC virtual function called whenever 
// the MDI child frame activation state changes. 

// Parameter: nState indicates the state. 

// If state is inactive, send a WM.NCPAINT after setting 
// mJActive. If state is active, don't do anything, 

// because you will get a OnActivateView as well for 
// the active view. 

I ****************************************** **************/ 

void ZCaptionFormView::0nActivateFrame (UINT nState, 
CFrameWnd* pFrameWnd) 

{ 

mJActive - (nState — WAJNACTIVE) ? FALSE : TRUE; 
if (nState = WAJNACTIVE) { 

if((m_nCaptionHeight > 0) && (::IsWindow (mJWnd))) 
SendMessage (WMJCPAINT); 

} 

CFormView::OnActivateFrame(nState, pFrameWnd); 


/ ******************************************************** j 

II OnNcCalcSize - MFC handler for WMJCCALCSIZE (read 
// documentation on message). This message is used to 
// calculate the client area of a window. Call Default 
// first to get the actual client area, and then return 
// an area minus the caption area. 

y******************************************************** j 

LRESULT ZCaptionFormView::0nNcCalcSize(WPARAM wParam, LPARAM IParam) 
{ 

LRESULT 1 Result - Default 0; 
if (mjiCaptionHeight > 0) { 

NCCALCSIZE_PARAMS FAR* lpncsp - 
(NCCALCSIZE_PARAMS FAR *)1Param; 
lpncsp->rgrc [0].top +- m.nCaptionHeight; 

} 

return IResult; 


I ********************************************************j 

// OnNcPaint - MFC handler for WMJCPAINT 
// No parameters 

// Draw the caption in the non-client area. The color 
// depends on whether is active or not. Some points to be 
// noted in this function: Use of GetWindowDC and using 
// a coordinate system wrt top-left of non-client area 
// rather than client coordinates. Calls out to virtual 
// function DoDrawCaption to do the actual drawing. 

/ ******************************************************** i 

void ZCaptionFormView::OnNcPaint() 

{ 

Default 0; // Draw other parts as normal, 

if (m_nCaptionHeight <- 0) // Optimize if Caption is off 
return; 

// Get the rectangle to paint. We use GetWindowRect and 
// then shift to window based (non-client) coordinates. 

// Effectively, we are only using the width of the window, 

// other values are set explicitly. 

RECT rect, windowRect; 

GetWindowRect (&windowRect); 

SetRect (&rect, 0. 0, windowRect.right - windowRect.left, 

mjiCaptionHeight + 1); 

// Get the window dc. Remember we are painting the 
// non-client area. 

CDC *pDC - GetWindowDC (); 
if (pDC) { 

DoDrawCaption (pDC, rect); // Call out to virtual fn. 
ReleaseDC (pDC); 

} 

else { // Could not get DC! 

TRACE0 ("ZCaptionFormView::0nNcPaint - " 

"GetWindowDC failed!. \n"); 

ASSERT (FALSE); 

} 


j ******************************************************** j 

II OnNcHitTest - MFC handler for WMJCHITTEST 
// Parameters: mouse at screen coordinates. 

// Call Default first. If mouse is HTN0WHERE, return 
// HTCLIENT. If this is not done, clicking on the 
// pseudo-caption will not activate this view. 

j ******************************************************** j 

UINT ZCaptionFormView::OnNcHitTest (CPoint point) 

{ 


I ********************************************************/ 
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WM_NCH ITTEST, it does not generate any further mouse messages 
(such as button clicks) until the mouse moves into a different 
area. So the trick is to trap this message and first pass it to the 
default window procedure, then check its return value. If the 
return value is HT_N0WHERE, then return HT_CLI ENT instead. Once 
Windows gets a HT_CLI ENT, it will send the correct activation 
events when the mouse is clicked there. 

Handling Activation Changes 

The code worked now, except that it did not repaint immedi¬ 
ately after the active view was changed. This was because I did 
not force a non-client repaint whenever the active view changed. 
You can force the non-client repaint by using two exposed CVi ew 
virtual functions: OnActi vateVi ew( ) and OnActi vateFramet). 

OnActi vateView() is called whenever the view is activated 
or deactivated. Depending on the active state, I set a flag and 
send a WM_NCPAI NT. The WM_NC PA I NT handler then checks the 
flag and draws the pseudo caption in the appropriate color. 
Once I overrode this virtual function and ran the application, 
it worked properly when the active view changed. I thought I 
had it working completely, until I switched to a different 
application. The last active view still sported a blue caption, 
where I expected it to have become inactive and to display the 
inactive caption color. Delving into MFC source code, I dis¬ 
covered that OnActi vateVi ew() is called whenever a view 
inside a particular frame is activated or deactivated — not 
when the frame itself becomes inactive. 

To handle active state shifts across frames, I needed to han¬ 


dle the virtual function OnActivateFrame( ), which is called 
whenever the frame associated with the view gains or loses 
the active state. In my override, I must handle the case when 
the frame loses focus, then set the active flag to FALSE and send 
a WM_NCPAI NT message. I don't handle the case when the frame 
gains the active state, because when it does, MFC internally 
calls OnActi vateVi ew, which we have overridden. I want to 
override OnActi vateVi ew () so I can send a WM__NC PA I NT. 

ZCaptionFormView 

I encapsulated WM_NCCALCS I Z E, WM_NCPAI NT, and 
WM_NCHITTEST into a class called ZCaptionFormView. Its imple¬ 
mentation is shown in zcapform.cpp (Listing 1); its definition 
is in zcapform.h (Listing 2). ZCaptionFormView inherits from 
CFormVi ew and provides pseudo-caption support for it. I have 
used CFormVi ew as the base class in this example, but you can 
use any CVi ew derived class instead. 

ZCaptionFormView provides interface functions to set and 
retrieve the caption text and to change the caption's height. 
Also, to allow you to derive from ZCaptionFormView and pro¬ 
vide your own draw implementation, the caption draw func¬ 
tionality has been kept in the virtual function DoDrawCaptionO. 

The sample code on the code disk (see Table of Contents 
for availability) is a standard AppWizard-generated appli¬ 
cation with the following options: MDI, large model, no 
print preview, and no VBX support. I then added a splitter 
frame using ClassWizard. I have changed 
CSplitterFrame: :OnInitiallipdate() (splitter.cpp) to create 
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a static splitter and added two form views. I also set the cap¬ 
tion for both views. Next, I created a dialog resource using 
AppStudio, and created a form view class based on this 
resource using ClassWizard. Instead of deriving the form 
view from CFormView, I changed the base class to 
ZCaptionFormView (myform.h). I added a menu item 'Switch 
View' to toggle the active state between the two form views 
(spl i tter. cpp). The command handler checks if the first view 
is active; if it is inactive, the handler sets the other view as 
active. I also changed the main file (generic.cpp) to use the 
splitter frame (CSpl itterFrame) — instead of CMDIChi IdWnd — 
while the document template is being added. 

Other Uses for WM_NCCALCSIZE 

By using the WM_NCCALCS IZ E message effectively, you can 
create windows with captions on the left, right, or bottom of a 
window rather than on the top. You can use this strategy to 
create vertical caption bars on the left or right of a MDI child 
window to display documents or images whose lengths are 
typically greater than their widths. This would cause the cap¬ 
tion bar to use up otherwise empty space, allowing the user 
to see additional text in the space vacated by the real caption. 
In such a situation, you would need to override 
DoDrawCaption ( ) to display the caption text vertically. 

To let the user move a window by clicking and dragging on 
the caption area, trap the WM_NCHITTEST message; if the cursor 
is over the pseudo-caption area, return HT_CAPTI ON and 
Windows will do the rest for you. 



V Video 

V Sound 

V Sprites 

V imaging 

V Graphics 

V Special effects 

V Seamless animation 

V Hyper-fast transparent blits 

V Versions for Windows 95, 
Windows 3.1 and Win32s 
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Listing 1 continued 


LRESULT 1 Result - Default 0: 

// Optimize if Caption is off 
if C(m_nCaptionHeight > 0) U (IResult - HTNOWHERE)) 
1 Result - HTCLIENT; 
return LOWORD (IResult); 


/***********************★********************************/ 
// DoDrawCaption - virtual function to draw caption. 

// Parameters: Pointer to DC to draw on, rectangle to 
// indicate area. 

// Point is wrt to 0.0 of window (not client). This version 
// draws the caption in the active caption color, and 
// prints out a caption as well. Override this function 
// to extend draw capabilities. m_bActive tells you whether 
// to draw in active colors, or inactive colors. 

I ********************************************************j 

void ZCaptionFormView::DoDrawCaption (CDC *pDC, 
const RECT& rect) 

{ 

CFrameWnd *pFrame - (CFrameWnd *)GetParentFrame 0; 
ASSERT (pFrame->IsKindOf (RUNTIME_CLASS (CFrameWnd))); 

// Decide color on whether the view is currently active. 
COLORREF color - (m_bActive) ? 

GetSysColor (C0L0R_ACTIVECAPTION) : 

GetSysColor (C0L0R_INACTIVECAPTION); 

CPen blackPen (PS_S0LID, 1, RGB (0, 0, 0)); 

CBrush blueBrush (color); 

// Select pen and brush and draw a rectangle. 

CPen ‘pOldPen - pDC->SelectObject (&blackPen); 

CBrush *pOIdBrush - pDC->SelectObject (&blueBrush); 
pDC->Rectangle (&rect); 

// Now, write the caption. 

pDC->SetTextColor ((m_bActive) ? 

GetSysColor (COLOR.CAPTIONTEXT) ; 
GetSysColor (COLORJNACTIVECAPTIONTEXT)); 
pDC->SetBkMode (TRANSPARENT); 

RECT rectText - rect; 

rectText.1 eft += LEFTJiARGIN; // looks better. 

CFont *pFont - GetFont (); 
if (pFont) 

pDC->SelectObject (pFont); 
pDC->DrawText (m_sCaption, m_sCaption.GetLength (), 
SrectText, DT.SINGLELINE | DTJCENTER); 
pDC->SelectObject (pOldBrush); 
pDC->SeIectObject (pOldPen); 

} 

//End of File 


Listing 2 zcapform.h — Interface for tiny 
caption class 


#ifndef _ZCaptionFormView_ 

#define _ZCaptionFormView_ 

#define DEFAULT_CAPTI0N_HEIGHT 15 // 15 arbitrary! 

class ZCaptionFormView : public CFormView 

{ 

public; 

ZCaptionFormView (UINT nID, int nHeight 
- DEFAULT.CAPTION.HEIGHT) 

; CFormView (nID), mjiCaptionHeight (nHeight), 
m_bActive (FALSE) 

{ ASSERT (m_nCaptionHeight >- 0); } 
ZCaptionFormView (LPCSTR 1pszTempTateName, 
int nHeight - DEFAULT.CAPTIONJEIGHT) 

; CFormView (1pszTemplateName), 
mjiCaptionHeight (nHeight), m.bActive (FALSE) 

{ ASSERT (mjiCaptionHeight >- 0); ) 

public; 
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Conclusion 

There are a number of Windows messages that almost 
never get used by applications. The ZCaptionFormView class 
uses three relatively unknown Windows messages to achieve 
a pseudo caption for CVi ew-derived objects. I used CFormView 
as a base class because it was required in my project. However, 
you can use it to create a pseudo caption for any window. 
Since it uses only Windows messages, the same application 
can be easily written using the C SDK or other class libraries 
(Borland's OWL already provides a TTi nyCapti on class to do 


the trick). You must detect the active state switch and call 
WM_NC PAI NT yourself, however. All this could have been avoid¬ 
ed if only the CSplitterWnd::RecalcLayout( ) function had 
been virtual! 

If you have successfully used other relatively obscure 
Windows messages to achieve interesting results, I would def¬ 
initely like to hear about it. O 


Listing 2 continued 


int GetCaptionHeight 0 const 
{ return m_nCaptionHeight; } 
void SetCaptionHeight (int nHeight) 

{ 

ASSERT (m_nCaptionHeight >= 0); 
m_nCaptionHeight = nHeight; 

} 

void GetCaption (CString& sCaption) 

{ sCaption - m_sCaption; } 
void SetCaption (LPCSTR szCaption) 

{ m_sCaption - szCaption; } 

protected: 

virtual void OnActivateView (BOOL bActivate, 

CView *pActivateView, CView *pDeactivateView); 
virtual void OnActivateFrame(UINT nState, 

CFrameWnd* pFrameWnd); 

virtual void DoDrawCaption (CDC *pDC, const RECT& rect); 


// Generated message map functions 

//{{AFX_MSG(ClnfoView) 

afx_msg LRESULT OnNcCalcSize(WPARAM wParam, 

LPARAM IParam); 
afx_msg void OnNcPaintO; 
afx_msg UINT OnNcHitTest (CPoint point); 

//}}AFX_MSG 
DECLARE_MESSAGE_MAP() 

DECLARE_DYNAMIC (ZCaptionFormView) 

protected: 

int m_nCapti onHei ght; 

CString m_sCaption; 

BOOL m_bActive; // TRUE if active, FALSE otherwise 


lendlf // _ZCaptionFormView_ 

// End of File 




And play. 
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The Least You Need to Know 
About OLE Compound Files 


Ron Burk 
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Watoom C++ v10.6 


A while back, I wrote a little Win95 utility called ClipBase that provided a hierar¬ 
chical tree of code fragments that you could browse and paste into your code (see "A 
Code Fragment Database for Windows 95," July 1995). To provide the hierarchical 
storage for that utility, I simply used a directory tree, where each subdirectory was a 
node in the database and each file contained a code fragment. Several readers sug¬ 
gested that a better choice would have been to use an OLE compound file. I think 
there are significant drawbacks to that approach, but eventually I decided to work 
with OLE compound files in a project, just so I would have some experience with 
them. As usual, the Microsoft documentation made this task more difficult than it 
needed to be. In fact, most programmers could probably understand and start using 
OLE compound files in about fifteen minutes, without having to learn much about 
OLE. This article contains the information I wish I had had when I started to use 
compound files. 

What Is a Compound File? 

An OLE compound file is simply a file system that resides in a single DOS file. It's 
not unusual for a particular application to implement a miniature file system in 
order to store complex data structures within a single file, and that's what OLE does 
for you (though in a more elaborate way than you would probably bother with for a 
single application). OLE's little file system is a tree structure with directories and 
files — a simple variation on UNIX or DOS file systems. One advantage of using a 
compound file is that, at the logical level, your application can store its data in a com¬ 
plex directory tree of files, while at the physical level, all those logical files reside in a 
single DOS file, so that the complexity is hidden from the user. One disadvantage is 
that all the tools for searching, dumping, deleting, viewing, and repairing DOS files 
will be useless for logical files stored in Microsoft's proprietary compound file for¬ 
mat. Microsoft's promise of a rich set of tools for operating on compound files, inde¬ 
pendent of the programs that created them, has never materialized. 


Ron Burk is the editor of Windows Developer's Journal. You may contact him at 
70302.2566@compuserve.com. 
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To reiterate, an OLE compound file is a DOS file that con¬ 
tains a proprietary (the format is still undocumented, as far as 
I know) tree-structured file system within it. Inside that single 
compound file, you can use OLE functions to create and 
manipulate files and directories. To make this more complex 
than it needs to be, Microsoft insists that you call a directory 
inside a compound file a "storage," and call the files that 
reside in compound files "streams." I will use that terminolo¬ 
gy here, since you will always see it in the Microsoft docu¬ 
mentation; personally, though, I always just say "directory" 
and "file." Keep this handy chart with you at all times: 

• storage == directory 

• stream == file 


Unicode Roadblocks 

Before jumping into code, I will take a slight detour. The 
OLE libraries comes in a 16-bit version and a 32-bit version, 
and they are not precisely the same. The 32-bit version often 
wants its strings supplied as Unicode, even though most 
Windows 95 applications will not be compiled to use Unicode. 
I will assume throughout this article that you are using a C++ 
compiler and compiling for either Windows 95 or Windows 
NT, which requires using 32-bit OLE. If your application does 
not use Unicode strings by default (most don't), you will need 
some wrapper functions for translating to and from Unicode. 
Here is a crude but effective pair of wrapper functions 
that I use: 

void A2U(const char* In, wchar_t* Out) 

{ 

int Len = (int)strlen(In)+l; 
MultiByteToWideChar(CP_ACP, 0, 

In, Len, Out, Len*2); 

1 

void U2A(wchar_t* In, char* Out) 

1 

int Len - istrlenW(In)+l; 
WideCharToMultiByte(CP_ACP, 0, 

In, Len, Out, Len, 0, 0); 

1 

In both cases, the functions assume that 
the output buffer (whether Unicode or 
ANSI) has enough space for the transla¬ 
tion, and they will merrily overwrite the 
end of the buffer if that assumption is 
false. This isn't very elegant, but since 
the main purpose of these functions is to 
translate the names of storages (directo¬ 
ries) and streams (files), it's fairly easy to 
define a MAX_NAME_LEN variable and stick 
to it throughout your program. 

If you have string constants in spe¬ 
cific places in your code (e.g., you have 
a particular file whose name is always 
"Data"), then you can use a Unicode 
string constant instead of converting an 
ANSI string constant to Unicode on the 
fly. You can create a wide (Unicode) ver¬ 
sion of a string constant by prepending 
an "L" to the string: 

CallSomeOleFunc(L”A Unicode constant!"); 

Creating a Compound File 

The quickest way to understand 
compound files is to jump in and start 
using them. You can create a compound 
file by calling the OLE function 
StgCreateDocFi 1 e( ). Assuming you are 
using a C++ compiler and compiling 
for Windows 95 or Windows NT, you 
can use the following code to create a 
compound file called C:\mydata.dat: 

continued on page 29 
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continued from page 24 


Listing 1 comdump.c — Program to dump 
OLE compound files 


#iDelude <stdio.h> 
ifinclude <stdlib.h> // exitO 
(/include <objbase.h> 

static void A2U(const char* In, wchar_t* Out) { 
int Len - (int)strlen(In)+l; 

MultiByteToWideChar(CP_ACP, 0, In, Len, Out, Len*2); 

} 

static void L)2A(wchar_t* In, char* Out) { 
int Len - 1strlenW(In)+l; 

WideCharToMultiByte(CP_ACP, 0, In, Len, Out, Len, 0, 0); 
} 

void DumpStreamtIStream* File, int Indent-0) { 

ULONG BytesRead; 

unsigned char Buffer[8]; 
int Offset - 0; 

while(Fiie->Read(Buffer, 8, &BytesRead) — S_0K 
M BytesRead >0) { 

printf("%*s0x%04X ", Indent, Offset); 
fortint i-0; i < BytesRead; ++1) 

printf(”%02X ", (unsigned int)(Buffer[i])); 
printf("\n"); 

Offset +- 16; 

} 

} 

void DumpStoragedStorage* Oir, int Indent-0) { 


HRESULT Code; 

IEnumSTATSTG* Enum; 
STATSTG Info; 

IStream* Stream; 


Dir->EnumElements(0, 0, 0, SEnum); 
whl1e(Enum->Next(1, &Info, 0) — S_0K) 

( 

// convert, print out info about this file or dir 
char Name[256]; 

U2A(Info.pwcsName, Name); 

prlntf("%*s/%s\n", Indent, Name); 

// if it's a storage, then open it and recurse 
if(Info.type -- STGTY.STORAGE) 

{ 

IStorage* SubOir; 

HRESULT Code - Dir->0penStorage(Info.pwcsName, 0, 
STGM_READ|STGM_SHARE_EXCLUSIVE, 

0, 0, SSubDir); 
if(Code !- S_0K) 

{ 

fprintf(stderr, "Could not open storage " 

%s'\n”, Name); 
exit(EXIT_FAILURE); 

} 

else 

{ 

DumpStorage(SubDir, Indent+4); 

SubDir->Releasel); 

} 

} 

// if it's a file, open and dump it 
else ifdnfo.type — STGTY_STREAM) 

{ 

IStream* File; 

HRESULT Code - Dir->0penStream(Info.pwcsName, 0, 
STGM_READ|STGM_SHARE_EXCLUSIVE, 

0, &Fi1e); 
if(Code !- S_0K) 

( 

fprintf(stderr, "Could not open stream " 
'"Xs’\n". Name); 
exit(EXIT_FAILURE >; 

} 

else 

{ 

DumpStreamtFile, Indent+4); 


(/include <windows.h> 

(/include <objbase.h> 

II... 

HRESULT Status; 

IStorage* Root; 
wchar_t wPath[256]; 

A2U(”C:\\mydata.dat", wPath); 

Status = StgCreateDocFilelwPath, 

STGM_READWRITE 
|STGM_SHARE_EXC LUSIV E 
|STGM_FAILIFTHERE, 

0, &Root); 
if(Status == S_0K) 

// then the file got created! 

As you might guess, the creation function also opens the file, 
and those STGM_ flags specify the mode that the compound file 
will be opened in. In this case. I'm opening the file for reading 
and writing, and I don't want to share it with other applica¬ 
tions — a typical scenario for a data file that belongs to a sin¬ 
gle application. 

That's about all you need to know to create a compound file, 
and you didn't have to learn about COM, MFC, aggregation, or 
anything else. Of course, once the compound file is created and 
open, you'll want to do something useful with it, like create 
streams (files) or storages (directories of files) inside it. 
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TYPE: Win32 
TOPIC: WinMain 
KEYWORD: WinMain 

Note that the string passed in IpCmdLine is not 
the same as the string returned by 
GetCommandLine(). The string in IpCmdLine 
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but GetCommandLine() returns the program 
name followed by the arguments. 

If you specify the following command: ‘winword 
abc.doc’, and winword exists in 
d:\msoffice\winword.exe, IpCmdLine will 
contain ‘abc.doc’, while GetCommandLine will 
return ‘“d:\msoffice\winword.exe” abc.doc’. 

Note the double quotes around the exe name. 
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StgCreateDocFil e( ) didn't return a C-style handle, it returned 
something of type IStorage* — what do you do with it? 

Using IStorage 

StgCreateDocFil e() gives you a pointer to a C++ object of 
type IStorage. Conceptually, IStorage is a handle to the root 
directory of the compound file, but you don't use it like a C- 
style file handle. Instead, you call member functions of the 
IStorage class to do the work. For example, to create the first 
stream (file) inside the root storage (directory) of my newly 
created compound file, I might write: 


IStream* Data Fi1e; 

// Root is of type IStorage, obtained 
// from previous code example 
HRESULT Code = Root->CreateStream( 
L”Data”, 

STGM.READWRITE 
|STGM_SHARE_EXC LUSIV E 
|STGM_CREATE, 

0, 0, ^Stream); 
if(Code -= S_0K) 

// then Data Fi1e is created and open! 


Listing 1 continued 


Fi 1 e->Release(); 

IStorage* Root; 

} 

HRESULT Result; 

CoTaskMemFree(Info.pwcsName); 

A2U(argv[l], wPath); 

} 

Result - StgOpenStoragetwPath, 0, STGM READ 

Enum->Re1ease(); 

|STGM SHARE EXCLUSIVE, 0, 0, &Root); 

1 

ifIResult !- S_0K) 

fprintf(stderr, "Could not open ’%s ’ (error code %d)”, 
argvfl], Result); 

void Usage(void) ( 

else 

fprintf ( stderr, "Usage: comdump <filename>\n"); 

( 

exit ( EX IT FAILURE); 

printf("Dump of compound file ' %s ' \n”, argv [1]); 

) 

DumpStorage(Root); 

Root->Re1ease(); 

void main(int argc, char** argv) { 

) 

if ( argc !- 2) 

exit(EXIT SUCCESS); 

UsageO; 

) 

wchar_t wPath[256]; 

'/* End of File */ 
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The CreateStreamO member function creates and opens a 
stream (file) inside the given storage (directory). This time, 
you get a pointer of type I Stream, which contains member 
functions appropriate for files (reading, writing, seeking, etc.). 

As with a normal DOS directory, a compound file storage 
(directory) supports creating streams (files), creating substor¬ 
ages (subdirectories), renaming streams/storages, deleting 
streams/storages, and so on. Most of these you can figure out 
fairly easily from the documentation, so I'll focus on the items 
most likely to be surprising. 

One surprise is the lack of a Cl 0Se() function. How do you 
tell OLE that you're finished with the IStorage or I St ream 
pointer? You call a member function called Release( ); do not 
try to use the delete operator on your IStorage or I Stream 
pointer. 

Another aspect of compound files that differs from DOS is 
the method of enumerating the contents of a storage (directo¬ 
ry). DOS provides get-first/get-next functions for obtaining 
the names of the files and subdirectories in a directory. The 
IStorage interface, however, gives you a function for obtain¬ 
ing yet another interface, called I EnumSTATSTG, which you can 
use to traverse the contents of a storage (directory), obtaining 
the names and sizes of its storages (directories) and streams 
(files). I will provide a detailed example of this later that you 
can cut and paste into your own code. 

Another interesting question is, how do you flush data to 
disk? This question has two answers. The first answer 
involves transaction protection, which I won't cover in this 
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just-enough-to-get-you-going article. 
The second answer is that there is sim¬ 
ple trick to flush data to disk. I Storage 
contains a member function, called 
Commit(), that is used with transaction 
protection. However, even if you are 
not using transaction protection, if you 
pass a zero to this function for the root 
storage, it will flush all memory buffers 
to disk: 

// flush data to disk 
Root->Commit(0); 


A Little Example 

comdump.c (Listing 1) contains a 
small example of using OLE compound 
files. This utility takes a DOS filename 
on the command line and, assuming it 
is an OLE compound file, produces a 
recursive dump of all the storages 
(directories) and streams (files) inside 
that compound file. The only compli¬ 
cated part is enumerating the contents 
of each storage (directory), which is one 
reason I chose this particular example. 


The I St or age member function 
EnumEl ements () gives you a pointer to 
an I EnumSTATSTG interface, which you 
can use to enumerate the "elements" 
(storages and streams) inside the stor¬ 
age. The I EnumSTATSTG interface offers a 
NextO member function, which fills a 
STATSTG structure with information 
about the next storage or stream. The 
Next () member function will fail after it 
reaches the last element. One of the 
fields in the STATSTG structure is a point¬ 
er to a Unicode string containing the 
name of the storage or stream. You are 
responsible for freeing the memory this 
string occupies. There are other ways to 
do this, but I used the simplest, which is 
to call the OLE function 
CoTa s kMemFree(). 

As you can see, operations such as 
reading bytes from streams are entirely 
analogous to ordinary file 1/O. Just be 
sure to call ReJ ease () when you want to 
close the storage or stream. Though the 
storages and streams you keep open 
occupy space in memory, they do not 
consume DOS file handles (other than 
the handles required to open the DOS 
file the compound file resides in), so 
you don't have to worry too much 
about minimizing the number of open 
streams or storages. 

Summary 

There's a lot more you can learn 
about OLE compound files, but I've 
used them successfully with only the 
information presented here. The first 
time I used them was somewhat 
painful, but thereafter I've been able to 
cut and paste my original work without 
much effort. Like nearly all Microsoft 
APIs, this one is not a thing of beauty. It 
has, however, significant functionality 
that comes preinstalled on all Windows 
95 and Windows NT machines, which 
can be a powerful incentive to take 
advantage of it in your applications. □ 
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The Overhead of Opening 
Registry Keys 

Paula Tomlinson 

Under Windows 95 and Windows NT, the registry has become a vast storehouse 
of information for applications. Most applications will have some interaction with 
the registry and many will have to perform a lot of registry reading and writing. 
I/O to the registry is not necessarily as efficient as I/O to a simple file, especially 
under Windows NT, which supports security features for registry keys. This article 
shows that it is sometimes worth the effort to pay attention to the overhead of reg¬ 
istry I/O when designing an application. 

Introduction 

I was recently perplexed to discover that some API routines I provide via a 
client-server RPC interface on Windows NT were not nearly as fast as I expected 
them to be. After doing a little profiling, I found the problem was centered in only 
two routines; one was a complex routine that was called only once and the other 
was a very simple routine that was called over 100 times in a loop. What these two 
routines have in common is that the bulk of the work in each consists of calls to the 
Win32 registry routines. There weren't any obvious logic flaws in the code; I simply 
opened registry keys, queried values, and closed the keys. The prospects for opti¬ 
mizing my routines seemed dismal. 

In my quest to understand where the bottleneck was, I started by looking at the 
more complex routine that was only called once. This routine basically built up a 
buffer of data from several different values in different keys in the registry and 
returned the buffer back to the caller. My initial implementation was probably the 
simplest and most straightforward — for each value, I performed the following 
steps: (1) open the registry key, (2) query the value, (3) process the data, and (4) 
close the registry key. The following code fragment is an oversimplified example of 
the basic code path. 

for (1-0; i < NUM_SUB_KEY$; 1++) { 

wsprintf(RegPath, 

"SoftwareHPaulaWxWyWzWKeyM", i); 

if (RegOpenKeyEx(HKEY_LOCAL_MACHINE, RegPath, 0, 

KEY_ALL_ACCESS, &hKey) == ERR0R_SUCCESS) { 

RegQueryVa1ueEx(hKey, "Value", NULL, NULL, 

(LPBYTEJ&dwValue, MwSize); 

// process the data and store in buffer 
RegCloseKey(hKey); 

1 

1 


Paula Tomlinson has been developing DOS, Windows, and Windows-NT based applica¬ 
tions and device drivers for eight years. The opinions expressed here are hers alone. She 
can be contacted via the internet at paulat@microsoft.com. 
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Finding the Overhead 

The culprit turned out to be the call 
to RegOpen Key Ex (). The problem was 
that I specified the complete registry 
path on each call to RegOpenKeyExt ). 
When RegOpenKeyExt ) is passed a reg¬ 
istry path containing multiple sub¬ 
keys, RegOpenKeyExt) must essentially 
perform an open operation on each 
subkey. Since there are security checks 
involved in each open operation on 
Windows NT, RegOpenKeyExt ) is a fair¬ 
ly expensive call. In my case, although 
each value I needed to query was 
stored under a different subkey, I had 
failed to take advantage of the fact 
that each key I opened was a subkey 
of the "Software\Paulat\x\y\z" key. 
My next implementation looked like 
this: 

if (RegOpenKeyExtHKEY_LOCAL_MACHINE, 
"SoftwareWPaulaWxWyWx", 

0. KEY_ALL_ACCESS, &hKey) == 
ERRORJUCCESS) { 

for (i-0; i < NUM_SUB_KEYS; i++) { 

wsprintf(RegKey, "KeyXd", i): 

if (RegOpenKeyExthKey, RegKey, 0, 
KEY_ALL_ACCESS,&hKeyl) — 
ERROR_SUCCESS) { 

RegQueryValueExt hKeyl, "Value", 
NULL, NULL, LPBYTE)&dwValue, 
KdwSize); 

// process the data and store in 

// buffer 

RegCloseKey(hKeyl): 

1 

} 

RegCloseKey(hKey); 

} 

Although the second implementation 
actually produces one extra call to 
RegOpenKeyExt ), and subsequently one 
extra call to RegCl oseKey (), the perfor¬ 
mance gain was significant for large 
values of NUM_SUB_KEYS. For example, 
on my system, with a value of 25 for 
NUM_SUB_KEYS, this second implemen¬ 
tation was 9 percent faster than my 
original implementation. The differ¬ 
ence is neglible for smaller values of 
NUM_SUB_KEY, and my original imple¬ 
mentation was actually faster for very 
small numbers (under 5). Also, 
remember that the registry is a hierar¬ 
chical database of information. It gen¬ 
erally takes longer to open a key that 
has several other keys at the same 
level in the hierarchy. 


Making similar changes to the more 
complex routine in my real application 
under normal usage netted roughly a 
10 percent improvement, which was 
well worth the small effort involved. 
However, in my second problem rou¬ 
tine, I opened only one registry key 
(and that registry key varied based on 
the caller), so the same optimization 
obviously wasn't helpful. The follow¬ 
ing code is a simplied example of that 
code path: 

void TestltULONG ulIndex, PULONG pulValue) 

1 

ULONG ulSize = sizeof(DWORD); 

CHAR RegKey[16]; 

HKEY hKey; 

wsprintfC RegKey, 

"SoftwareWPaulaWxWyWzWKeyM", 
ul Index); 

if (RegOpenKeyEx(HKEY_LOCAL_MACHINE, 
RegKey, 0, KEY_ALL_ACCESS, &hKey) 
== ERRORJUCCESS) { 

RegQueryValueEx(hKey, "Value", NULL, 
NULL, (LPBYTE)pulValue, &ulSize); 

if (*pulValue != ullndex) { 
printf("Error\n"): 

1 

RegCloseKey!hKey); 

} 

1 


Once again, the key 
"Paula\Software\x\y\z" is common 
for all invocations of this routine. This 
time, I decided to measure the perfor¬ 
mance gained by opening a key to 
"Paula\Software\x\y\x" the first time 
the routine is called and leaving it open 
for subsequent calls. My optimized 
routine looked like this: 

void Test2(UL0NG ullndex, PULONG pulValue) 

{ 

ULONG ulSize - sizeof(DWORD); 

CHAR RegKey[16]: 

HKEY hKey; 

if (ghBaseKey — NULL) { 

RegOpenKeyExtHKEY_LOCAL_MACHINE, 
"SoftwareWPaulaWxWyWz", 

0, KEY_ALL_ACCESS, &ghBaseKey); 

} 

wspri ntf (RegKey, "KeyM", ullndex); 

if (RegOpenKeyExtghBaseKey, RegKey, 0, 
KEY_ALL_ACCESS, &hKey) == 
ERRORJUCCESS) { 

RegQueryValueExthKey, "Value", NULL, 
NULL, (LPBYTE)pulValue, &ulSize); 
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if (*pulValue !- ulIndex) { 
printf("Error\n"); 

} 

RegCloseKey(hKey); 

} 

} 

In this case, the performance gain is 
proportional to the number of times the 
routine is called. In my test cases, I 
called several thousand times, and the 
second version was roughly 20 percent 
faster than the first version. When I 
used a similar enhancement to my real 
application, under normal usage per¬ 
formance increased by approximately 
15 percent. 

What about Windows 95? 

Although I also noticed perfor¬ 
mance improvements when I ran my 
tests on Windows 95, the difference 
was less pronounced in all cases. This 
was not surprising — since Windows 


95 does not perform security valida¬ 
tion, the overhead of opening registry 
keys is less. There were no cases, how¬ 
ever, where my optimizations for 
Windows NT caused a performance 
degradation for Windows 95. 

Conclusion 

• If your application makes calls to the 
registry only occasionally, then none 
of this matters. The performance 
effects I mentioned above are evident 
only in registry-intensive applica¬ 
tions. Also, since the registry contents 
are file-based, the caching support 
provided by the operating system 
can completely overwhelm subtle 
differences in performance if there 
are only a few calls. The percentages I 
noted earlier were averages of thou¬ 
sands of test runs. 

• For those applications that are truly 
registry-intensive, you should care¬ 
fully examine how you open registry 
keys. RegOpenKeyExO is a relatively 


expensive call, especially in 
Windows NT. 

• Optimize the number of registry keys 
that must be opened internally by 
RegOpenKeyExO, not just the number 
of calls you make to RegOpenKeyExO. 

•In general, RegOpenKeyExO gets pro¬ 
gressively slower as the number of 
registry keys at the same level in the 
registry increases. 

• Finally, if your implementation 
allows this, it can really pay off to 
keep a handle open to commonly 
accessed registry keys throughout 
the lifetime of your program. □ 
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Calling Microsoft DLLs from 
Borland C++ 

Ron Burk 

Windows 3.x DLLs offer a standard function interface so that anyone can create 
functions that any other Windows 3.x language/environment can call. Or do they? 
In fact, the standard DLL function interface is not a rigorous standard, which can 
cause problems for programmers. This article shows what to watch out for and how 
to work around it. 

Introduction 

I'm building a viewer for our upcoming CD-ROM of back issues using 
Microsoft's MediaView, a free toolkit for creating programs like the MSDN CD-ROM 
viewer. MediaView comes in the form of a set of DLLs, and, as usual, I designed my 
code to work with both Borland and Microsoft compilers. However, with just the 
barest functionality in place, my program crashed after I rebuilt the project with the 
Borland compiler, though it still worked correctly when built with the Microsoft 
compiler. This is one of the main reasons I regularly build my projects with multiple 
compilers — to flush out bugs in my code that might otherwise cause no visible 
problem. 

In this case, however, after thoroughly inspecting my code, I could see no prob¬ 
lem. It seemed that if I called a particular MediaView DLL function from Borland, 
my program crashed, even though I verified that I was passing precisely the same 
data as in the Microsoft version of the project. With few options left, I began tracing 
through the call in assembly language. It soon became apparent that the Borland 
code was not pushing the same number of bytes on the stack to call the function as 
the Microsoft code. Suddenly, it hit me — these two compilers disagree on how to 
implement the Pascal calling sequence in some cases. I already knew this, was true 
when returning floating-point parameters. In fact, a different problem arises with 
other types of variables, as I'll explain. 


Ron Burk is the editor of Windows Developer's Journal. You may contact him at 
70302.2566@compuserve.com. 
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Returning Structures 

In the 16-bit Pascal calling sequence, a function that 
returns an int simply returns the value in the AX register. A 
function that returns a long returns it in the DX:AX. But how 
does a function return a structure that is too large to fit in any 


Figure 1 Calling Microsoft DLLs from 
Borland C++ 


/* macros to handle Borland/Hicrosoft incompatibilities */ 
#if defined(_MSC_VER) 

# define PTMVGETSCROLLSIZES ptMVGetScrol1 Sizes 

#el1f defined!_BORLANOC_) 

t define PTMVGETSCROLLSIZES BorGetScrollSizes 

#el se 

It error Unknown compiler! 

#endif 

#1f defined!_BORLANDC_) 

typedef int (FAR PASCAL *BORGETSCROLL$IZES) 

(LPMV Mv, WORD StackOfs); 

POINT BorGetScrollSizestLPMV Mv) 

( 

POINT Result; 

BORGETSCROLLSIZES Func - 

(BORGETSCROLLSIZES)ptMVGetScrol1 Sizes; 

FuncfMv, LOWORD(&Result)); 
return Result; 

) 

fendlf 


set of 80x86 registers? For example, consider the following 
16-bit DLL function: 

struct Stack 
{ 

int Count; 
int Vars[20]; 

1; 

^define EXPORT _export_pascal 

Stack EXPORT CreateStacktint Size) 

{ 

/* ... */ 

} 

How can this function return that 42-byte structure? In fact, 
this requires cooperation between the caller and the callee. 
The caller is required to allocate space on the stack for the 
returned structure, and then to pass an extra hidden parame¬ 
ter that contains the offset in the stack of that temporary vari¬ 
able. The callee then uses the hidden parameter to copy the 
data it wants to return. 

Microsoft uses this technique for all structures. Borland, 
however, uses a more optimal approach. If the structure is 
small enough, Borland returns the structure value in regis¬ 
ters. Obviously, for either approach to work, the callee and 
caller had better agree on it; otherwise, the result will be the 
kind of mysterious GP fault I saw in my program. 
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A Workaround 

You might think that small structures are fairly rare, but 
one very common small structure is POINT, which is defined 
in windows. h. POINT contains just two integers, so it can fit in 
the DX:AX (just like a long). Did you ever notice that among 
the hundreds of Windows API functions, not one returns a 
POINT? Instead, they require that you pass the address of a 
POINT, to which data is then copied. If any of these functions 
did return a POINT, that function would not work properly 
when called from Borland C/C++. 

The designers of the Media View DLL did return POINTs in 
their API, which left me a bit stranded. It is possible to work 
around problems like this without descending into assembly 
language or having to buy a Microsoft compiler to build a 
wrapper DLL. I'll show how I did it for the case of a Borland 
function calling a Microsoft function that returns a POINT. 

The function I needed to call had a declaration like this: 

POINT EXPORT ptMVGetScrol1 Si zest LPMV Media); 

It takes a single argument (basically a handle) and returns a 
POINT. The problem is, the DLL was compiled with a 
Microsoft compiler, so the DLL function expects an extra hid¬ 
den parameter containing the offset on the stack of a tempo¬ 
rary POINT variable. My solution was to use some judicious 
casting to fool the Borland compiler into producing the call¬ 
ing sequence the Microsoft compiler expected. I then 


wrapped all this in conditional code so that the source could 
still be compiled with either Microsoft or Borland compilers. 
The result is in Figure 1. 

First, the code defines a wrapper macro that will expand 
into a direct call to the problem function when compiled with 
Microsoft, or into a call to a wrapper function when compiled 
with Borland. The Borland wrapper takes the address of the 
wrapper function and casts it into a pointer to a function that 
takes an additional integer argument. The wrapper then calls 
that function, passing its normal argument, but also an addi¬ 
tional argument — the offset of a stack variable of type POINT. 
Finally, the wrapper function returns the POINT, using, of 
course, the Borland calling sequence. 

Summary 

This calling sequence incompatibility is as old as 
Windows, but most programmers don't stumble onto it. 
When you do, it can appear as a mysterious fatal bug unless 
you realize what is happening. Whenever you see a DLL 
function that returns a small structure or a floating-point 
value, you should immediately wonder what compiler the 
DLL was compiled with. A future article will describe compil¬ 
er incompatibilities in the new Win32 calling sequences. For 
16-bit code, however, programmers who create or call DLLs 
should be aware of the problem and the options for working 
around it. □ 
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Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they should! 
You'll receive at least $50 for each tip 
that we print. 

Send your submissions: 

- via the Internet to: 
leor@bdsoft.com 

- from CompuServe to: 
>INTERNET:leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
North Reading, MA 01864 


Problem with "new and Jhuge" in Visual C++ 1.52 


Mike E. Mikailov 
Gaithersburg, MD 

If you try to run the main!) function shown in hugedemo . cpp (Listing 1), it will fail 
on the line 

hugeNew = new _huge HUGE_NEW_TEST [1024L * 26L] 

There are three ways to get around this problem: 

• Replace 26 with 20 or another number that results in total memory allocation of 
less than 128Kb. 

• Add anew field, BYTE byTestl [3];, to the HUGE_NEW_TESTstructure to make its size 
a multiple of four. 

• Replace the line 

hugeNew - new _huge HUGE_NEW_TEST [1024L * 26L]) 
with 

hugeNew - (HUGE_NEW_TEST*) new _huge 

char [1024L * 26L * sizeof (HUGE_NEW_TEST)]) 

As you can see, huge memory allocation using new will fail when the size of the new'd 
chunk is greater than 128Kb and the memory pointer points to a structure size that is 
not a multiple of four. The problem is solved when the structure size becomes a mul¬ 
tiple of four. 

A QuickWin application, huge_new. exe (created using Visual C++ 1.52 and demon¬ 
strating the problem), is available electronically (see Table of Contents for availability). 

Some Useful DAO Exception Handling Macros 


Mark Gorokhov 
gorokhml@smtp.atg-net.com 

To develop reliable code for Database Access Objects (DAO) in Visual C++ 4.0, 
you must use the exception-handling mechanism. In the code that I wrote recently 
for this purpose, all catch blocks were very similar in different parts of the program. 
Therefore, to save time and source code size, I used a couple of #def i ne statements: 

#define DAO_CATCH_AND_RETURN_NULL 




Leor Zolman is a consultant specializing in C/C++ programming training, an instructor 
on UNIX topics for Boston University's Center for Information Technology, and "Tech 
Tips" editor for Windows Developer's Journal. His book, Illustrated C, was pub¬ 
lished in 1992. He may be contacted at 74, Marblehead St., North Reading, MA 01864. 
Internet address: leor@bdsoft.com. 
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and 


#define DAO_CATCH_AND_RETURN_CLOSE 


Listing 1 hugedemo.cpp — Demo of prob¬ 

lem with “new” and “huge” 


/* function demonstrating problem with "new" and "huge": */ 

//include <windows.h> 

#include <stdio.h> 


typedef struct { 

DWORD dwTest ; 

BYTE byTest ; 

//BYTE byTestl [ 3 ] ; //If uncomment this will work! 
} HUGE_NEW_TEST ; 


void main 0 
{ 

HUGE_NEW_TEST _huge* hugeNew : 

if (NULL — (hugeNew - new _huge HUGE_NEW_TEST [1024L * 26])) 
{ 

printf ( "\nNo memory!" ) ; 

} 

else 

{ 

printf ( "\nYes memory!" ) ; 

} 

if (hugeNew) 

{ 

delete [] hugeNew ; 

) 


//End of File 


The parameter passed to DAO_CATCH_AND_RETURN_NULL() is a 
string containing additional information that may help the 
programmer pinpoint the location of a problem. 
RETURN_NULL means return a FALSE value as well. I found 
that DAO_CATCH_AND_RETURN_NULL() and 

DAO_CATCH_AND_RETURN_CLOSE() covered the majority of stan¬ 
dard catch situations. Figure 1 contains the macros and 
some usage examples. 



A Generic Method for Changing the Font Used 
by Controls in a Dialog Box 


George F. Frazier, Ph.D. 
Farallon Computing, Inc. 

Lawrence, KS 
georgef@farallon.com 


I've noticed that a lot of applications locked in 16-bit incarna¬ 
tions are trying to borrow some of the styles from Windows 95. 
This includes using non-bold fonts for dialog box controls. If you 
are using MFC, you can create a non-bold font and use Set Font () 
to change your dialog's font in its On Ini tDi al og() method. But 
this doesn't change the font for the dialog's child control win¬ 
dows (or, recursively, for their child control windows, etc.). 

A generic trick that uses no specific knowledge of a dialog's 
controls defines a base class, TNonBol dDi al og, that inherits from 
CDialog. TNonBol dDi alog has a member, SetupFontf ), that gets 
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Figure 1 DAO exception handling macros 


// DAO Exception handling macros and examples: 


#define DAO_CATCH_AND_RETURN_NULL(str) \ 

catch (CDaoException* e) \ 

{ \ 

FuncDisplayDaoException(str. e); \ 

e->Delete(); \ 

return NULL; \ 

} \ 

catch (CMemoryException* e) \ 

{ \ 

FuncDisplayMemoryException(str, e); \ 

e->Delete(); \ 

return NULL; \ 

} \ 

//define DAO_CATCH_AND_RETURN_CLOSE(str, db)\ 
catch (CDaoException* e) \ 

{ \ 

FuncDisplayDaoException(str. e); \ 

e->Delete(); \ 

return FuncCloseAndDeleteDB(db); \ 

} \ 

catch (CMemoryException* e) \ 

{ \ 

FuncDisplayMemoryException(str, e); \ 

e->Delete(); \ 

return FuncCl oseAndDeleteDB(db); \ 

1 \ 


CDaoDatabase* FuncCloseAndDeleteDB(CDaoDatabase* pDB) 
{ 

ASSERT(pDB); 

if (pDB->IsOpen()) // without throw 
pDB->Close(); // without throw 
delete pDB; 
return NULL; 

} // FuncCloseAndDeleteDBO 


{ 

FuncDisplayMemoryErrorCstrMsg); 
return NULL; 

} 

try 

{ 

pDB->Create(lpszDBPathName, dbLangGeneral, dbEncrypt); 

} 

DAO_CATCH_AND_RETURN_CLOSE(strMsg, pDB); 
return pDB; 

} // FuncCreateNewDatabaseO 


void FuncDisplayDaoException(CString& strMsg, CDaoException* e) 
{ 

CString str - "Dao Exception.\n"; 
str +- strMsg; 
str +- "\n\n"; 

if (e->m_pErrorInfo !- NULL) 

{ 

CString strFmt; 
strFmt.Format( 

"%s (Xd)\n", 

(LPCTSTR)e->m_pErrorInfo->m_strDescription, 
e->m_pErrorInfo->m_lErrorCode); 

str +- strFmt; 

AfxMessageBox(str); 

} 

AfxMessageBox(strMsg); 

} // FuncDisplayDaoExceptionO 


void FuncDisplayMemoryException(CString& strMsg, 

CMemoryException* /*e*/) 

{ 

CString str - "Out-of-Memory Exception.\n"; 
str +- strMsg; 

AfxMessageBox(str); 

} // FuncDisplayMemoryExceptionO 


CDaoDatabase* FuncOpenDatabase(LPCTSTR IpszDBPathName) 
{ 

CString strMsg - "Couldn't open database \""; 
strMsg +- IpszDBPathName; 
strMsg +- 

CDaoDatabase* pDB - new CDaoDatabase; 
if (pDB — NULL) 

{ 

FuncDisplayMemoryError(strMsg); 
return NULL; 

} 

try 

{ 

pDB->0pen(IpszDBPathName); 

} 

DAO_CATCH_AND_RETURN_NULL(strMsg); 
return pDB; 

} // FuncOpenDatabaseO 


CDaoDatabase* FuncCreateNewDatabase(LPCTSTR IpszDBPathName) 
{ 

CString strMsg - "Couldn't create database \""; 
strMsg +- IpszDBPathName; 
strMsg +- "\""; 

CDaoDatabase* pDB - new CDaoDatabase; 
if (pDB - NULL) 


Figure 2 SetupFontQ Member Function 


II SetupFontO for the TNonBoldDialog class: 

void TNonBoldDialog::SetupFont() 

{ 

CFont *pfontDlg; 

LOGFONT 1 Font; 

pfontDlg - GetFontO; 

if (pfontDlg !- NULL) 

{ 

pfontDlg->GetObject(sizeof(LOGFONT), &1Font): 

1 Font.IfWeight - FW_N0RMAL; 

if (m_StaticFont.CreateFontIndirect((LPLOGFONT) &1Font)) 

{ 

SendMessageToDescendants(WM_SETFONT. 

(UINT)m_StaticFont.m_hObject); 

} 

} 

} 
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called in its On Ini tDial og () method. SetupFont () creates a non¬ 
bold version of the current dialog font and then broadcasts a 
WM_SETFONT message to all descendants of the dialog (its child 
control windows) with the new font's handle. Figure 2 shows 
the code (note that m_Stati cFont is a private member of the 
class). 

The CWnd member function SendMessageToDescendants() 
broadcasts the WM_SETFONT message to all child controls in the 
dialog. By inheriting from TNonBoldDialog and invoking its 
On Ini tDial og () function, your dialog will get the non-bold 
font for all child controls in the dialog. When implementing 
TNonBoldDialog, make sure the destructor cleans up after the 
CFont object you created with the following statement: 

m_StaticFont.DeleteObject(); 


DirectDraw Debugging 


Dan Shappir 
shappir@math.tau.ac.il 


DirectDraw is the graphic component of the DirectX pack¬ 
age that forms Microsoft's Game Development Kit (GDK). 
DirectDraw allows the developer to get as close to the actual 
graphic hardware as is possible under Windows 95. This is 


Listing 2 simlock.h 


// simlock.h 

//ifndef SIMLOCK.H 
//define SIMLOCK.H 

//include <windows.fi> 

//include <ddraw.h> 

//ifdef_cplusplus 

extern "C" { 

//endif 

BOOL 

CreateBuffer(const DWORD dwWidth, 
const DWORD dwHeight, 
const DWORD dwBpp); 

VOID 

FreeBuffer(VOID); 

LPVOID 

LockBufferUPRECT 1 pRect); 

HRESULT 

UniockBuffer(LPDIRECTDRAWSURFACE lpDDSurface); 

//ifdef_cpl uspl us 

) 

//endif 

//endif 

//End of File 


Listing 3 simlock.c 


II simlock.c: 

//include <malloc.h> 
//include "simlock.h" 

static LPSTR lpBuffer; 



Listing 3 continued 


static DWORD dwBufferWidth; 
static DWORD dwBitsPerPixel; 
static DWORD dwSize; 

BOOL 

CreateBuffer(const DWORD dwWidth, 
const DWORD dwHeight, 
const DWORD dwBpp) 

{ 

FreeBufferO; 

dwBufferWidth - dwWidth; 

dwBitsPerPixel - dwBpp; 

dwSize - (dwWidth*dwHeight*dwBpp)/8; 

lpBuffer - malloc(dwSize); 

return lpBuffer !- NULL; 

} 

VOID 

FreeBuffer(VOID) 

{ 

free(lpBuffer); 

} 

LPVOID 

LockBuffer(LPRECT IpRect) 

{ 

if ( lpBuffer && IpRect ) ( 

DWORD dwOff - ((1pRect->top*dwBufferWidth+ 

1pRect->left)*dwBitsPerPixel)/8; 
return (LPVOID)(1pBuffer+dwOff); 

} 

return (LPV0ID)1pBuffer; 

} 

HRESULT 

UniockBuffer(LPDIRECTDRAWSURFACE 1pDDSurface) 

{ 

if ( lpBuffer ) { 

HRESULT hResult; 
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Listing 3 continued 


DDSURFACEDESC ddsd; 

ZeroMemory(&ddsd, sizeof(ddsd)); 
ddsd.dwSize - sizeof(ddsd); 
hResult - IDirectDrawSurface_Lock(1pDDSurface, NULL, 
&ddsd, DDLOCKJAIT, 
NULL); 

if ( hResult !- DD_0K ) 
return hResult; 

memcpy(ddsd.lpSurface, lpBuffer, dwSize); 

return IDirectDrawSurface_Unlock(1pDDSurface, NULL); 

} 

return DD_OK; 

} 

//End of File 


essential to achieve an acceptable performance level in the 
final product, but it can make the development process more 
difficult. 

You can use DirectDraw to create applications that address 
the entire screen, effectively hiding the Windows interface. To 
avoid screen update conflicts, you must place a topmost win¬ 
dow over the entire screen before starting this mode: 

hwndApp = CreateWindowExtWS_EX_APPWINDOW, szAppName, szAppName, 
WS_P0PUP I WS_SYSMENU | WS_CAPTION, 

0 , 0 , 

GetSystemMetrics(SM_CXSCREEN), 

GetSystemMetrics(SM_CYSCREEN), 

NULL, NULL, hlnst, NULL): 


The problem is 
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that, during development, this window 
obscures your debugging environment 
along with the rest of Windows. For this 
reason, during development I prefer to 
use DirectDraw in a window, with the 
appropriate Di rectDrawCl ipper object, 
even if the final product is intended to 
be a full-screen application. I switch to 
full screen only in the final stages of 
development (usually just before I 
switch from debug to release). 

Another DirectDraw debugging 
issue derives from the fact that when 
you lock a Di rectDrawSurface using the 
LockO member function to retrieve a 
pointer to the actual surface memory, 
you also effectively lock the entire sys¬ 
tem. You can't use the debugger built 
into the Development Studio until you 
unlock the surface. This is unfortunate 
because, in my experience, the render¬ 
ing code often requires extensive 
debugging. To circumvent this prob¬ 
lem, during development I perform the 
rendering to a conventional memory 
buffer, which is then copied to the 
Di rectDrawSurface. I switch to render¬ 
ing directly to the surface memory only 
in the final stages of development (after 
the rendering routines have been fully 
debugged). 

simlock.c (Listing 3) implements 
this double buffering mechanism. Note 
that the actual locking and unlocking 
operations are performed in 
Uni ockBuf fer (). To keep the code as 
simple as possible, I copy the entire 
buffer, rather than just the area request¬ 
ed in the lock operation. Performance is 
not a factor because this code is used 
only during debugging and is therefore 
not included in the final application. □ 
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Last month, I talked about interactive services. This month 
I will continue the discussion of interactive services by exam¬ 
ining how services create processes that can interact with a 
user. I will also answer a reader's query about the differences 
between pausing and stopping a service. Finally, I'll provide 
some sample code for performing self-installation and self¬ 
removal of a service. 

A Reader Question 

Your article ("How to Write an NT Service, " February 1996) 
was very timely for us. Using it with the Nigel Thompson arti¬ 
cle in the Tech Dev library worked out very well. We are con¬ 
sidering using an NT service as a method of automatically 
launching some of our database server clients. However, when 
calling CreateProcess () from an NT service, it seems that the 
process does not get started, even though CreateProcess() 
returns TRUE and the processlnfo structure is filled. 

Cl oseHandl e( ) also returns TRUE when passed the handle 
returned by CreateProcess (). When run in test mode as a con¬ 
sole app, everything works correctly. I am using notepad as the 
test process to create. 

Luis Garcia 


It's not uncommon for a service to need to create another 
process (and often that process is intended to be interactive), 
so this is a very important question. What's probably happen¬ 
ing here is that the notepad process is getting started, but you 
cannot see the window it is creating. The reason for this is a 
fundamental aspect of interactive services that I did not men¬ 
tion in last month's column. To really understand what's 
going on with interactive services, you must understand what 
window stations and desktops are. 


Understanding NT 


More on Services 

Paula Tomlinson 

Window Stations and Desktops 

The Windows NT operating system creates and manages 
secure objects called "window stations" and "desktops" (see 
Figure 1). Conceptually, a window station virtualizes certain 
aspects of the Windows user interface (e.g., the clipboard), so 
that you could have more than one person log on to one 
machine at the same time (in current versions of NT, only one 
interactive person can log on at a time, but more than one ser¬ 
vice can log in at the same time). A desktop virtualizes the tra¬ 
ditional Windows desktop window that lies behind all the 
other windows. When an NT process needs to take over the 
screen (as the login process does, for example), it can create a 
new desktop and make that the active desktop. This is a much 
more robust and secure way for a program to get control of the 
entire screen than was possible before; one previous method 
was to create a window that covered the screen, then try to 
keep other processes from inadvertently popping their win¬ 
dows on top of yours. Whenever user input occurs, it is in the 
context of a specific window station, and whenever screen 
output takes place, it is in the context of a specific desktop that 
belongs to a specific window station. 

When a user logs on interactively, the system automatically 
creates a window station called the interactive window station 
and a desktop called the application desktop. Currently, 
Windows NT supports only one interactively logged-on user 
so there can be only one interactive window station (this could 
change in versions after Windows NT 4.0). There can be multi¬ 
ple non-interactive window stations. All window stations con¬ 
tain a clipboard object, a global atom table, and one or more 
desktop objects. The interactive window station is the one 
whose current desktop is visible to the user and contains, in 
addition to the other window station objects, the keyboard, 
mouse, and display objects. In contrast, non-interactive win¬ 
dow stations are not visible and don't receive user input (they 


Paula Tomlinson has been developing DOS, Windows and Windows-NT based applications and device drivers for eight years. The opin¬ 
ions expressed here are hers alone. She can be contacted via the internet at paulat@microsoft.com. 
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can't, since they don't contain mouse or 
keyboard objects). Note that non-interac¬ 
tive window stations still have desktops, 
and a process associated with a non¬ 
interactive window station may believe 
it is creating windows and drawing on 
the screen. It's just that the output is not 
visible on any physical screen. 

A desktop belongs to a window sta¬ 
tion and contains the set of windows 
that are visible at a given time. The 
application desktop is the desktop that 
typical applications interact with, but 
there are at least two other desktops that 
are created by default when a user logs 
on — the Winlogon desktop and the 
screen saver desktop. The screen saver is 
a special desktop used by screen savers, 
and the winlogon desktop is the special 
desktop that is used to display the logon 
screen that authenticates user accounts. 
The name of the interactive window sta¬ 
tion happens to be Wi nStaO. The name of 
the default application desktop (for the 
interactive window station as well as 
other window stations) is Default (see 
Figure 1). Applications are free to create 
and interact with window stations and 
desktops via the API functions listed in 
Table 1. 

Since each window station is associ¬ 
ated with a logon session, any applica¬ 
tions that are started in the context of 
that logon session are also associated 
with the same window station. 
Applications that are started by a user 
after the user has logged on can assume 
that they're running on the interactive 
window station (Wi nStaO) and thus 
need not worry about window stations 
at all. For services, it's a completely dif¬ 
ferent story. With one exception, ser¬ 
vices are always associated with a dif¬ 
ferent window station than the interac¬ 
tive window station. These window 
stations typically have names of the 
form Service-OxO-xxxx (where xxxx is 
some number associated with the user 
account and logon session). Only ser¬ 
vices running under the LocalSystem 
account and marked as interactive are 
associated with Wi nStaO, which is why 
these are the only services that are 
allowed to interact with users. 

I've heard people claim that a service 
that logs on to the same account as the 
interactive user can also be interactive, 
but this is not true. The service must 
have an association with Wi nStaO to cre¬ 


ate a window the user can see. Any 
process my service creates will by default 
be associated with the same window sta¬ 
tion my service is associated with. Given 
all this, there are several ways to create 
an interactive process from a service. In 
all cases, the goal is to ensure that the cre¬ 
ated process is associated with Wi nStaO 
(the interactive window station). 


Creating Interactive 
Processes from a Service 

Option 1 

The simplest way to accomplish this 
is to mark your service as interactive 
(assuming the service is running under 
the LocalSystem account). You can do 
this through the CreateService( ) call 


User logs on - 

interactive logon session is created 



A non-interactive service is started by 
the service controller - a non-interactive 
logon session is created 



Figure 1 Window stations and desktops 
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when the service is installed, or use the Services control panel 
applet to mark an installed service as interactive. A service that 
is marked as interactive is associated with the interactive win¬ 
dow station and default interactive desktop (Wi nStaO\Defau11), 
as are any processes it creates. However, for security purposes, 


Table 1 Window Station and Desktop API 
functions 


Window Station fuctions 

CloseWindowStation 
CreateWindowStation 
EnumWindowStation 
GetProcessWIndowStation 
OpenWIndowStation 
SetProcessWindowStation 

Desktop Functions 

CloseDesktop 

CreateDesktop 

EnumDesktops 

EnumDesktopWIndows 

GetThreadDesktop 

OpenDes ktop 

SetThreadDesktop 

Functions used with Window Stations and Desktops 

GetUserObjectlnformation 
GetUserObjectSecurity 
SetUserObjectInformatIon 
SetUserObjectSecurity 
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it's generally best not to give the service itself any unnecessary 
privileges. If the service itself doesn't need to be interactive, 
then you might consider one of the other options. Also, don't 
forget that a user can override the interactive flag for all services 
by setting the following value in the registry: 

HKEY_LOCAL_MACHINE 

\System 

\CurrentControl Set 
\Control 
\Windows 

NoInteractiveServices:REG_DW0RD:1 

This means your service must be prepared to find itself unable 
to interact with the user. 

Option 2 

The next easiest method is to hardcode the default name of 
the interactive window station and desktop in the call to 
CreateProcessO. This works now (and in fact is recommend¬ 
ed in the Win32 SDK under the topic of "Creating an 
Interactive Process"), but to assume that it will continue to 
work would be dangerous, since future versions of Windows 
NT might allow multiple interactive users to log on. To use 
this method, your service would create a process by using the 
following code fragment: 

STARTUPINFO si; 

P R0CESS_IN FORMAT ION pi; 

si.cb = sizeof(STARTUPINFO); 

si.IpReserved = NULL; 

si.lpTitle - NULL; 

si.dwX = si.dwY = 0; 

si.dwXSize = si.dwYSize - 0; 

si.dwFlags - 0; 

si.wShowWindow - SW_SH0W; 

si.ipReserved2 - NULL; 

si.cbReserved2 = 0; 

si.ipDesktop - "WinStaOWDefault"; 

CreateProcess(NULL,szAppName,NULL, 

NULL,FALSE,0,NULL,NULL,&si,&pi); 

Option 3 

In some client-server implementations, interactive 
processes communicate with the service via an IPC mecha¬ 
nism, such as RPC or named pipes. In response to those client 
requests, the service may need to create a process to perform 
various tasks. In this scenario, you could require that the 
client (which is an interactive process) pass some information 
to the service. One obvious choice is the name of the window 
station and desktop. The client application could use the code 
fragment in Figure 2 to retrieve the name of the window sta¬ 
tion and the desktop it is associated with. The service could 
then use those two strings to form the 1 pDesktop field of the 
STARTUPINFO structure that is passed to CreateProcessO. 

Alternatively, the client process could simply pass its 
process ID (retrieved by calling GetCurrentProcessO) to the 
service. The service would then execute the following code: 

hProcess = OpenProcessCPROCESS_ALL_ACCESS, TRUE, pid); 
OpenProcessTokenthProcess, TOKEN_ALL_ACCESS, &hToken); 
CreateProcessAsUser(hToken, ...); 
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The advantage of this method is that the new process runs in 
the security context of the client process, rather than in 
LocalSystem. Creating a process that runs in the security con¬ 
text of LocalSystem is considered a dangerous practice, since 
LocalSystem generally has enough permissions to wreak 
havoc on the local machine. 

Finally, don't forget that stopping the service does not nec¬ 
essarily stop any processes the service created. You should 
take this into account in your service code. If your service sim¬ 
ply created a process each time it initialized, then the service 
would generate another running instance of the process each 
time it stopped and restarted the service. 

Pausing versus Stopping a Service 

Thanks for the useful article. I had this question: what's the dif¬ 
ference between pausing and stopping a service? Using the 
control panel Services applet, even a stopped service can be 
started again (it's not like stopping it makes it unavailable). In 
other words, are there any guidelines to distinguish between 
the two, or is it entirely up to the developer? Thanks in 
advance for your help. 

Stephen Cooper 


When a service receives the SERVI CE_C0NTR0L_ST0P control, it 
should perform any tasks necessary to clean up resources and 
stop whatever work it might be currently performing. This 
often entails terminating any threads the service created and 
flushing any data to disk or the registry, etc. If your cleanup 
operations might consume more than a couple of seconds, you 
should tell the operating system that you are attempting to stop 
your service by making frequent calls to SetServiceStatusO 


Figure 2 Obtaining the Window station and 
desktop names 


TCHAR szDesktop[MAX_PATH], szWinSta[MAX_PATH]; 

ULONG ulSize: 

HWINSTA hWinSta: 

HDESK hDesktop; 

// Get the current window station 
hWinSta - GetProcessWindowStationO; 
if (hWinSta) { 
ulSize - MAX_PATH; 

if (!GetUserObjectInformation(hWinSta,UOI_NAME.szWinSta, 
ulSize, &ulSize)) { 

IstrcpytszWinSta, IWinStaOT): 

} 

1 

else { 

lstrcpy(szHinSta, iWinStaOi); 

1 

// Get the current desktop 
hDesktop - GetThreadDesktop(GetCurrentThreadldO): 
if (hDesktop) { 
ulSize - MAX_PATH; 

if (!GetUserObjectInformation(hDesktop,U0I_NAME, 
szDesktop,ulSize,&ulSize)) { 
l$trcpy(szDesktop, Default); 

} 

} 

else { 

1strcpy(szDesktop, Default); 

1 

// pass szWinSta and szDesktop to service 


with the dwCurrentState field of the SERVICE_STATUS structure 
set to SERVICE_STOP_PENDI NG. A service informs the operating 
system that it has successfully stopped by calling 
SetServiceStatusO with dwCurrentState set to 
SERVICE_STOPPED. After a service has reported a successful stop, 
the call to StartServiceCtrl Dispatcher( ) (typically in the ser¬ 
vice's ma i n ()) will return if: 

•the service is of type S E RVIC E_W I N32_0WN_P ROC ESS (the 
process isn't shared by multiple services), or 
• the service is of type SERV I CE_W I N32_SHARE_PR0CESS and all 
other services within the process have already been stopped. 

When the call to StartServi ceCtrl Dispatcher!) returns, the 
service process should terminate. So, stopping a service might 
terminate the service process. If you need to force a service to 
reinitialize itself, it may be necessary to stop the service and 
then restart it. If, on the other hand, you simply need the service 
to be inactive for a period of time, it's much more efficient to 
pause the service and continue it later. This is why I highly 
encourage service writers to support the 
SERVI CE_CONTROL_PAUSE control if at all possible. To indicate that 
your service supports pausing, set the SERV I CE_PAUSE_CONTI NUE 
flag in the dwDesi redAccess parameter on the call to 
CreateServiceO. For obvious reasons, you must also support 
Conti nue if you support Pause. 

As I demonstrated in the February 1996 article ("Flow to 
Write an NT Service"), if you create an event to wait on before 
returning from the ServiceMainO routine, then you can simply 
signal this event whenever a S E RV ICE_C0NTR0 L_ST0 P is 
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received. If the main work of the service is performed by one or 
more worker threads, then pausing and continuing a service 
can be as easy as pausing and resuming those worker threads. 
The service's handler routine might look something like this: 

case SERVICE_C0NTR0L_ST0P: 

SetServiceStatust...); // SERVICE_STOP_PENDING 
SetEvent(hDoneEvent); 

SetServi ceStatusl...); // SERVICEJTOPPED 
break; 

case SERVICE_C0NTR0L_PAUSE: 

SetServiceStatusf...); // SERVICE_PAUSE_PENDING 
SuspendThread(hThread); 

SetServiceStatusl...); // SERVICE_PAUSED 
break; 

case SERVICE_C0NTR0L_C0NTINUE: 

SetServiceStatust...); // SERVICE_CONTINUE_PENDING 
ResumeThread(hThread); 

SetServiceStatust...); // SERVICE_RUNNING 
break; 

In each case, the first call to SetServiceStatust) is overkill, 
since setting an event or suspending/resuming a thread is a 
fairly quick operation. 

Finally, note that services get to choose whether or not they 
are stoppable, just as they can choose whether or not they may 
be paused. The EventLog service is an example of a service 
that cannot be paused or stopped. If you attempt to stop a ser¬ 
vice that has not declared itself stoppable, the 
Control Service!) call will fail. The Services Control Panel 
applet grays out the Stop button for any service that is not 
stoppable. Even a service that has declared itself stoppable 
may fail to stop, but the SERV I CE_CONTROL_STOP control is not a 
"suggestion"; a service should make every attempt to stop 
when requested to do so. 
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Self-Installing Services 

There seems to be growing support for services to imple¬ 
ment some form of self-installation and self-removal. I think 
this idea has merit for three reasons. First, during the develop¬ 
ment of the service it's very convenient to be able to easily 
install and remove it from the services database. Second, 
power users may come to expect this feature of services run¬ 
ning on their systems. Third, it may be convenient to pro¬ 
grammatically install and remove services by simply calling 
CreateProcessO and passing the appropriate command-line 
parameter. I've chosen to model my service installation and 
removal after the service sample code on the Microsoft Win32 
SDK (also available on VC++ 4.1). Microsoft's service exam¬ 
ple proposes using the command-line parameters -install 
and - remove (a / character is also acceptable in place of the -) 
to command the service to install itself or remove itself. In fact, 
the sample code supports a -debug option, which you may 
also want to consider supporting. 

Since the code required to perform the installation and 
removal is very portable across services, I wrote a little 
reusable routine — srvcmd. C (Listing 1) — that you can use to 
add self-installation and self-removal to your services. 
ServiceCommandsO takes as parameters the command-line 
arguments (argc and argv), the service name and the display 
name. To hide all the work completely inside 
ServiceCommandsO, I added some very rudimentary error 
message output. Of course, these messages will be displayed 
only if the service is run from the command line. If a com¬ 
mand line is provided, but it doesn't match any of my known 
commands, then I display the commands and syntax I sup¬ 
port. If ServiceCommandsO returns TRUE, then some command 
line was passed and was processed (either successfully or 
not). In this case, I assume that the service was not called by 
the service controller, so I exit the process immediately. 
Likewise, if ServiceCommandsO returns FALSE, then no com¬ 
mand line was specified, so I assume it was called by the ser¬ 
vice controller (your service is probably already making this 
assumption), and I continue starting the service. This self¬ 
installation and self-removal approach generally assumes that 
the process supports only one service. 

To use ServiceCommandsO, a service mainO routine might 
look something like this: 

void maintint argc, char **argv) 

1 

SERVICE_TABLE_ENTRY ServiceTable[] - { 

I GENSRV_ServiceName, 

(LPSERVICE_MAIN_FUNCTION)ServiceMain}, 

{NULL, NULL) 

1 ; 

if (ServiceCommands(argc, argv, GENSRV_ServiceName, 

GENSRV_DisplayName)) { 
return; 

1 

// connect to the service control manager 

StartServiceCtrlDispatcher(ServiceTable); 

1 

The -install option results in a call to CreateServiceO. Note 
that I hardcoded several parameters in the CreateServi ce( ) call. 


Page 52 —Windows Developer’s Journal 


July 1996 









You may wish to modify some of these parameters or make 
them parameters in ServiceCommandst ). The -remove option is 
only slightly more complicated because it may have to stop the 
service before removing it. Since a service may take some time 
to stop, Servi ceCommands {) follows the SDK example of polling 
the service until it has successfully stopped. 
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Listing 1 srvcmd.c — Automatic service installation/removal 


II srvcmd.c 

ifinclude Windows.h> 
ifinclude <tchar.h> 
i/include <stdio.h> 

VOID Displaylnstructions(VOID); 

BOOL ServiceCommands!1nt argc, char **argv, 

LPTSTR szServiceName, LPTSTR szOisplayName) 

{ 

SC_HANDLE hSCManager, hService; 

TCHAR szPath[MAX_PATH]; 

if (argc <- 1) return FALSE; 

if ((*argv[1] - || (*argv[l] - '/')) { 

if (lstrcmpi(argv[l]+l, "install") — 0) ( 

//. 

// install the service 

//. 

if ((hSCManager - OpenSCManagertNULL, NULL, 


SC_MANAGER_ALL_ACCESS))) { 

GetModuleFileName(NULL, szPath, MAX.PATH); 

if ((hService - CreateServicethSCManager, 
szServiceName, szDisplayName, 

SERVICE_ALL_ACCESS, 

SERVICE_WIN32_0WN_PR0CESS, 
SERVICE_DEMAND_START, 

SERVICE_ERR0R_N0RMAL, 

szPath, NULL, NULL, NULL, NULL, NULL))) { 

CloseServiceHandle(hService); 

_tprintf(TEXT("Service installed.\n")); 

} else { 

_tprintf(TEXT("Installation failed\n")); 

} 

CloseServiceHandle( hSCManager); 

} else ( 

_tprintf(TEXT("Installation failed\n")); 

} 

} 

else if (lstrcmpi(argv[l]+I, "remove") -- 0) { 
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Listing 1 continued 

//. 

// service is stopped, remove it 

// Remove the service 

if(DeleteService(hService)) { 

//. 

_tprintf(TEXT ( "Service removed.\n") ) ; 

} else { 

if (( hSCManager - OpenSCManager ( NULL, NULL, 

tprintf(TEXT ( "Remove failed.\n”) ) ; 

SC_MANAGER_ALL_ACCESS) ) ) { 

) 

SERVICE_STATUS ss; 

CloseServiceHandlethService); 

if ((hService = OpenService(hSCManager. 

} else ( 

szServiceName, SERVICE_ALL_ACCESS)) } { 

CloseServiceHandle(hSCManager): 
tprintf(TEXT ( "Remove failed.\n") ) ; 

// Attempt to stop the service 

} 

if (ControlService(hService. 

} else { 

SERVICE_C0NTR0L_ST0P, Sss)) { 

_tprintf(TEXT ( "Remove failed.\n" )) ; 

tprintf(TEXT("Stopping the service.")): 

SIeep(2000 ) : 

} else { 


DisplaylnstructionsC ) ; 

while(Query$erviceStatus(hService, Sss)) ( 

} 

if ( ss.dwCurrentState — 

) else { 

SERVICE_STOP_PENDING) { 

DisplayInstructions () ; 

tprintf ( TEXT( ".")) ; 

SIeep(2000 ) : 

} 

} else { 

return TRUE; 

break; 

} 

} 

) 

VOID Displaylnstructions(VOID) 

if (ss.dwCurrentState — SERVICE STOPPED) { 

( 

tprintf(TEXT("\nService stopped.\n")) : 

printf("Thls service supports the following commands:\n"); 

) else { 

printft” -install (Installs the service)\n"); 

tprintf(TEXT("\nRemove failed.\n")) ; 

) 

printfC -remove (Remove the service)\n"): 

) 

) 

/* End of File */ 


Windows 

□ DEVELOPER'S JOURNAL 

The Magazine for Windows Programmers 


Windows Developer's Journal buys dozens of articles each year 
from readers like you. You don’t have to be a writer, but you do 
have to have a concrete topic of interest to other Windows pro¬ 
grammers. Most of the articles we use are built around short 
(100-300 lines), reusable code that solves specific problems of 
interest to Windows programmers. We are especially interest¬ 
ed in Visual Basic article proposals at this time. The easiest 
way to propose an article topic is to send email about your idea 


Call for Papers 

to the editor, Ron Burk, via CompuServe at 70302,2566 or 
Internet at 70302.2566@compuserve.com. Make sure you 
include an estimate of the number of lines of code involved. 

If you don’t have access to email, you can fax your proposal to: 
Managing Editor, Windows Developer’s Journal, (913) 841-2624, or 
mail it to: Managing Editor, Windows Developer’s Journal, 1601 
West 23rd St., Suite 200, Lawrence, KS 66046-2700. 

(913) 841-1631; FAX (913) 841-2624. 


Communications/ 

Networks 

■ Proposals due 14 June 1996 
manuscripts due 15 July 1996 
Suggested topics: A reusable func¬ 
tion that emails the contents of an arbi¬ 
trary dialog box to an arbitrary address. 
How to write vendor-independent code 
to communicate with Internet browsers. 
A reusable function for installing a given 
address in a MAPI address book. 


Graphics 

■ Proposals due 15 July 1996 
manuscripts due 16 Aug 1996 
Suggested topics: The world’s 
smallest icon editor. How to give win¬ 
dow backgrounds a textured look. 
Tips for minimizing window repaint¬ 
ing. A function to stretch bitmaps with 
anti-aliasing. 


MFC 

■ Proposals due Aug 1996 
manuscripts due Sept 1996 

Suggested topics: A listview exten¬ 
sion that lets the user edit, reorder col¬ 
umn titles. A treeview extension that 
provides automatic tooltips when the 
mouse is over a clipped tree item. An 
MFC framework for presenting com¬ 
pound files in treeview controls. An MFC 
class that lets the user edit image lists. 
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TTC Gopher OCX Control 


Victor R. Volkman 

Introduction 

TTC Gopher, by Edward B. Toupin (Highlands Ranch, CO), 
is an OLE Custom Control (OCX) that provides Gopher client 
access to any Win32 OLE container application. With TTC 
Gopher and a Windows Sockets TCP/IP protocol stack, your 
applications can immediately tap the huge repository of docu¬ 
ments on the Internet. Gopher was originally developed as a 
campus information server at the University of Minnesota. 
However, it quickly spread throughout the Internet as the first 
universal method for distributed document search and 
retrieval. The hallmarks of Gopher are its simple textual inter¬ 
face, hierarchical menu system, and stateless connections. TTC 
Gopher can be incorporated into any Win32 development 
environment that supports OLE containers, such as Visual 
C++ 2.0 and Visual Basic 4.0. TTC Gopher works with 
Windows NT 3.5 (or later) or Windows 95, but excludes sup¬ 
port for Windows 3.1 with Win32s. 

Installing TTC Gopher is straightforward enough that 
a setup program is not required. You 
can either copy gopher.ocx to your 
\windows\system directory or leave it in 
an application directory. Then run the 
supplied regsrvr32.exe application, 
which will insert necessary keys into the 
Windows registry (see Figure 1). 

Methods and Properties 

The gopher, ocx control uses 
GOPHER. QueryServer () to provide its inter¬ 
face. The advantage of this implementa¬ 
tion is its simple and universal calling 
sequence. A disadvantage is that your 
application must understand something 
of Gopher's protocol structure. Though 
gopher. OCX is strictly a non-GUI interface, 
the nature of the protocol is such that the 
data can be almost directly "pasted" into 
another control (such as a VB Outline 
control). 

The QueryServer () method, as docu¬ 
mented in VB parlance, is as follows: 


GOPHER.QueryServer(SrvrAdrs As String, Query As String, 

OutApp As String, PortNum As String) 

The first parameter is the 32-bit IP address of the server in dot¬ 
ted octet notation (e.g., "152.160.13.1"). If you have a name 
(e.g., "HAL9K.COM") and don't know the IP address, then 
you must either call the Windows Sockets WSAGetHostByName () 
or use the TTC gethost. ocx control to do it for you. 

The Query parameter is the Gopher selector used to navi¬ 
gate through the Gopher menus. This query can basically 
return a file, a directory listing, or a pointer to another server. 
You can find the root menu of a Gopher simply by querying 
with an empty string (""). I discuss Gopher query results in 
more detail in the next section. 

If the query item is a file, then the OutApp parameter indicates 
where to store the file (e.g., c : \gopher\spool \rf cl436. txt). If the 
query item is a remote host, then you must set the OutApp para¬ 
meter to the name of the Telnet application you wish to launch 
(e.g., c : \i netapp$\wtnvt. exe). A single-character prefix tells you 



Product Information 

Products: 

TTC Gopher OCX Control, vl.OOa (07/10/95) 

Filename: 

ttcgoph.zip; ttcutils.zip 

Address: 

Edward B. Toupin 

448 East Arden Circle 

Highlands Ranch, CO 80126 

USA 

ASP Member: 

No 

Email: 

Internet: etoupin@toupin.com 

CompuServe: 

[75051,1160] 

GO INETRE, Library #4 

FTP: 

ftp.csn.net: / etoupin 

WWW: 

http://www.toupin.com/-etoupin/ccc.html 

Registration: 

$35 

Evaluation: 

30 days 

Source Code: 

N/A 

Alternately, you can download TTCGOPH.ZIP from HAL 9000 BBS: +1 313 663 

4173 or telnet HAL9K.COM. 


Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He has been a contributing editor to 
Windows Developer's Journal since 1990. He is the author of the new book Windows Programming with Shareware Tools. He 
can be reached by dial-in at the HAL 9000BBS (313) 663-4173, by Usenet mail to sysop@hal9k.com, or telnet hal9k.com. 
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what type of object the query item repre¬ 
sents (see Figure 2). 

The final parameter. PortNum, indi¬ 
cates which TCP port to use. Even 
though the Gopher protocol is not an 
official standard, its port has been offi¬ 
cially designated as number 70 by the 
IANA. On a UNIX system, port num¬ 
bers are mapped to port names (and 
vice versa) in the /etc/services file. 

If QueryServer () fails, then the 
ErrorNum property will be set. 
QueryServer( ) doesn't modify any of its 


input parameters; rather, it returns the 
result of a query as a block of text. 
This format typically provides the 
impetus for the user to choose another 
item. 

More about Gopher 
Query Results 

QueryServer () returns the query 
results from the server in a continuous 
string without doing any parsing for 
you. Thus, the results are as document¬ 


ed in RFC 1436. Figure 3 shows the 
results of querying the root menu of 
rawBi ts .micro, umn. edu. Each line of text 
represents a menu item and is terminat¬ 
ed by a newline. A period (".") on a line 
by itself indicates the end of the data 
stream. 

Characters delimit the items within 
each line. At the beginning of each line 
is an item that tells what type of entity 
the line describes (see Figure 2), fol¬ 
lowed by a textual description. RFC 
1436 strongly recommends displaying 
the text with an icon indicating the 
type. 

The text between the first and sec¬ 
ond tabs is the gopher "selector." If the 
user selects this item in the client pro¬ 
gram, the selector should be passed 
unmodified to the Gopher server. Note 
that this selector will be a zero-length 
string if it is intended to refer to the root 
menu of another Gopher server. 

The Gopher server name appears 
immediately after the second tab. In 
keeping with the philosophy of 


VBX vs. OCX 

Much of the appeal of VBXs 
derives from their ease of use in a 
design mode and the clean interface 
for accessing methods, events, and 
properties. Unfortunately, the VBX 
interface was designed when 16-bit 
applications were the norm and 
Microsoft has been slow to provide 
compatability in true 32-bit environ¬ 
ments. OCXs were introduced both 
to circumvent this situation and to 
further leverage the use of Object 
Linking and Embedding (OLE). 
Another advantage of OCXs is that 
they allow for custom methods. 

OLE objects are already similar to 
VBXs in that they are composed of 
properties, methods, and a user 
interface. OCX controls can be 
embedded in any application that 
supports OLE containers, and are 
always embedded OLE — rather 
than linked — objects. Microsoft 
Access version 2.0 forms. Visual 
C++ 2.0, and Visual Basic 4.0 all sup¬ 
ply OLE container capabilities. See 
the MS Developers Library CD- 
ROM for more info on OCXs. O 





-lint 


for C/C++ 
Version 7.0 

presents Bug # 752 
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#include <iostream.h> 





2 







3 

int sum = 0; 






4 
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class Add 
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< 
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public: 
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Add( int 

a, int b, int c 

> t 

sum + = a 

Add 

x(b,c); } 

9 

Add( int 

a, int b ) 

t 

sum + = a 

Add 

x(b); > 

10 

Add( int 

a ) 

t 

sum += a 

; Add 

x(); } 

11 

Add() 


t 

cout << 

sum; 

sum =0; } 

12 

>; 






13 







14 

int main() 






15 

t 






16 

Add x( 21, 15, 9 ) ; 





17 

return 0 






18 

> 







In deplorable style, this program attempts to use constructors to add 3 numbers 
and print the results but sadly nothing gets printed. Can you spot the flaw? Call 
if you need a hint. Refer to Bug #752. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Version 7 of PC-lint breaks new ground with 
inter-statement value tracking for both 
automatic variables and class data members. 
Taking clues from assignment statements, 
initializers and conditional expressions it can 
detect out-of-bound subscripts and potential 
null pointer uses. As an enabling technology, 
almost 100 standard functions are rigorously 
checked. Also macros are subject to increased 
scrutiny, checking for unparenthesized 
parameters, unparenthesized bodies and 
repeated arguments having side-effects. 

Plus Our Traditional C/C++ Warnings: 
Uninitialized variables, inherited non-virtual 
destructors, strong type mismatches, 


inadvertent name-hiding, suspicious 
expressions, etc., etc. 

Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lintfor C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2, NT and Windows 95. 
This price is subject to increase. 

FlexeLintfor C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing. 


PA add 6% sales tax. 


3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610) 584-4266 

30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 
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address-independent names, this is 
normally a fully qualified Internet 
domain name (though an IP-address in 
octet form is also acceptable). Beyond 
the third tab is the port number of the 
Gopher server associated with this 
item. 

In summary, a given Gopher query 
result can contain any number of 
lines of text. Each line can describe 
any type of object which can reside on 
any local or Internet server. (You can 
perhaps guess how a Gopher search 
service, such as Veronica, could be 
implemented.) 

Gopher Extensions 

TTC Gopher provides only a few 
amenities beyond RFC 1436-mandat- 
ed functionality: saving files into 
buffers and the ftphack extensions. In 
addition to saving information from 
Gopher to files, you can output the 
information to a buffer. Simply leave 
the OutApp string empty ("") and TTC 
Gopher will retain the data in a buffer. 
This buffer is in turn passed back to 
the container application so that you 


can manipulate the information for 
use within your application. 

The ftphack extension allows you to 
use a Gopher-to-FTP gateway as a 
proxy for navigating FTP servers. This 
requires a designated Gopher-to-FTP 


gateway, such as the one provided by 
gopher.cit.correll.edu on port num¬ 
ber 7071. The TTC Gopher documenta¬ 
tion provides a long sample run 
demonstrating how to pull files from 
ftp.microsoft.com. 



F i g U re 1 TTC Gopher registry keys 




SENTRY 

SPELLING 

CHECKER 

ENGINE 


Checks text strings and edit controls 
^ Includes 100,000-word American and 
British dictionaries 
Use our built-in dialogs or write your 


Dutch, Finnish, French, Italian, German, Spanish, and 
Swedish dictionaries available 
Integrates easily with C/C++, VB, and Delphi apps 
^ Royalty Free 

Portable C source code available 
16- and 32-bit SDKs just $169.00 each 


THESDB 

THESAURUS 

DATABASE 


* Synonyms and antonyms for over 
40,000 key words 

> Words classified by parts of speech: 

Adjectives, adverbs, nouns, and verbs 

> Integrates easily with C/C++, VB, and Delphi apps 
’ Add your own synonyms to a user thesaurus 

Royalty Free 

Portable C source code available 

> 16- and 32-bit SDKs just $399.00 each 


FREE DEMOf .'Download SSCE.ZIP or THESDB.ZIP from CompuServe’s 
WINSDK forum, Public Utilities library. Or call for your free copy. 

MOKE /AffO.'Visit our Web page at http://fox.nstn.ca/-wsi or call. 


Sales: 1-800-340-8803 

Win+eH'+ee 


S O F T W A R 


Phone: 613-825-6271 
FAX: 613-825-5521 
Email: wsi@fox.nstn.ca 


Object Reports 

STOP waiting 10 minutes for a 2 page report! 

STOP coding report logic in some slow, unfamiliar, 
interpreted macro language! 

STOP exporting your object-oriented database to a 
relational database just to produce reports! 

STOP wasting your time filling in gaps with DDE! 

STOP querying, filtering, and extracting temporary 
tables just to make your report writer happy! 

STOP creating simple reporting applications that 
require 5MB of diskspace and 8MB of FtAM! 

STOP explaining to your users why your report writer 
can't generate the reports they want! 


Object Reports is not another report writer. Object 
Reports is a C++ class library that positions your data 
on the page. You create the report framework in C++ 
and send it data. Code all of your report in C++. 
Preview the output. Works with any GUI library. 
Static-or dynamic-link. Less than 150K. 

Small! Fast!! Efficient!!! 



source code included!!! 
Borland, Microsoft, Symantec 
16- and 32-bit Windows 

Rollins Software Inc 
http://www.rollinssoft.com 
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Documentation, Licensing, and Support 

An accompanying Windows help file contains the TTC 
Gopher documentation in its entirety. Toupin provides an 
extensive amount of background material on the Internet and 
TCP/IP protocols, even to the extent of diagramming and dis¬ 
secting packet headers. This is perhaps the most comprehen¬ 
sive coverage of such that I've seen in a shareware product. As 
you might expect, the major part of the documentation centers 
on Gopher query formats and how to interpret them. The 
manual neglects a few minor items, such as a list of error 
codes and what they mean. 

TTC Gopher should also include a copy of RFC 1436 in its 
archive distribution. This document explains the process in 
more detail than the TTC Gopher manual does. I believe TTC 
Gopher could be improved considerably with the addition of 
a model Gopher client in Visual Basic. 

Since TTC Gopher is marketed as shareware, you may 
evaluate it for up to 30 days. If you plan to use it beyond this 
period or distribute it with an application, you must register 
the product. Registration is $35 and includes technical sup¬ 
port. Toupin also distributes OCXs for many popular Internet 
protocols, including Finger, FTP, SMTP (email), NNTP (news). 
Time, DNS (GetHost), and Whols. WWW client and server 
OCXs are forthcoming. 

Toupin recognizes that software is prone to bugs; he is the 
only shareware author I know of who provides a software 


problem report form. This form is available in the Windows 
help file and is also attached to his WWW home page. Toupin 
writes: 

I try to respond with new versions within 24 hours if bugs are 
found, however, sometimes it does take longer. I do, however, 
always respond regardless of the situation. 

Technical support help is available only via email. 

Further Reading 

The Gopher protocol has not been offically adopted as an 
Internet standard. However, the definitive documentation for 
it has been released in a paper entitled “The Internet Gopher 
Protocol" (March 1993, The University of Minnesota). This 
specification has been registered as RFC (Request For 
Comment) 1436. 

You can get RFC 1436 by anonymous FTP from: 
ds.internic.net:/rfc/rfcl436.txt 

or download rfcl436.txt from the HAL 9000 BBS (see the 
Product Information box for further information). □ 



J SDK Annotation #122 

TYPE: MFC 1.5x 

TOPIC: CCmdTarget::GetlDispatch 
KEYWORD: GetIDispatch 

The documentation incorrectly states that this 
function takes no parameters. It should read: 

LPDISPATCH GetIDispatch (BOOL bAddRef) 

bAddRef - specifies whether to increment the 
reference count for the object. 

This has been corrected in the MFC 4.0 
documentation. 

Submitted by V. Ramachandran. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 


Figure 2 Gopher item type characters (as 
specified in Internet RFC#1436) 


The client software decides what items are available by looking at 
the first character of each line in a directory listing. Augmenting 
this list can extend the protocol. A list of defined item-type 
characters follows: 

0 Text file 

1 Directory 

2 CSO phone-book server 

3 Error 

4 BinHexed Macintosh file 

5 DOS binary 

6 UNIX uuencoded file 

7 Index-Search server 

8 Text-based telnet session 

9 Binary file (unspecified) 

+ Redundant server 

T Text-based tn3270 session 

g GIF format graphics file 

I Some kind of image file (client decides how to display) 

Characters ’O’ through are reserved. Local experiments should use 
other characters. Machine-specific extensions are not encouraged. Note 
that for type 5 or type 9 the client must be prepared to read until the 
connection closes. There will be no period at the end of the file: the 
contents of these files are binary and the client must decide what to do 
with them based perhaps on the .xxx extension. 


F i g U re 3 Typical Gopher query results 


OAbout internet Gopher [TAB] Stuff:About us [TAB] rawBits.micro.umn.edu [TAB] 70 
lAround Univ of Minnesota [TAB] Z.5692.AUM [TAB] underdog.micro.umn.edu [TAB] 70 
IMicrocomputer News [TAB] Prices/ [TAB] pserver.bookstore.umn.edu [TAB] 70 
ICourses and Schedules [TAB] [TAB] events.ais.umn.edu [TAB] 9120 
IStudent-Staff Directories [TAB] [TAB] uinfo.ais.umn.edu [TAB] 70 
IDepartmental Pubs [TAB] Stuff:DP: [TAB] rawBits.micro.umn.edu [TAB] 70 

Note that [TAB] represents the ASCII tab character (0x09) 
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Bug++ of the Month 

Mark Nelson 


If you discover a bug in the latest version of your favorite compiler, 
email it to us at wdletter@mfi.com. Please specify which version of 
your compiler you are using and include a tiny program that 
demonstrates the problem, along with the exact command-line 
options needed to compile it. 

As I was going up the stair 

I met a man who wasn't there. 

He wasn't there again today. 

I wish, I wish he'd stay away. 

— "The Psychoed" by Hughes Meams 

Now that Visual C++ 4.0 has been out for a few months, I 
expected to begin seeing some interesting bugs unique to that 
release. This month's bug, reported by Finnish WDJ reader 
Timo Kettunen, is more than just interesting — I found it 
quite educational as well. 

Classes with No Data Members 

Timo's problem stems from an interesting characteristic of 
C++ classes. It seems that if you create a concrete class with 
no data members, the class must still have a size greater than 
0. I wasn't aware of this requirement, but I went to the C++ 
draft specification, and sure enough, section 5.3.3 states: 

The size of any class or class object is greater than zero. 

Most compilers seem to deal with this by inserting a dummy 
one-byte member into a class to prevent it from breaking that 
rule. Visual C++ does just that. In my test program, 
bug0796. cpp, (Listing 1), I created a base class that does nothing: 


class A { 

}; 

If you print out si zeof ( A ), the compiler correctly reports 
that this class occupies one byte. Note that if you allow the 
compiler to generate a default assignment operator, you will 
even copy that unused byte from one object to another! The 
following listing fragment was generated by Visual C++ 
using the / Fc option: 

; 6 : A a; 

; 7 : A b; 

; 8 : a - b; 

00009 8a 45 f8 mov al, BYTE PTR _b$[ebp] 

0000c 88 45 fc mov BYTE PTR _a$[ebp], al 

Optimizing Away the Dummy Byte 

None of this is particularly alarming, but it gets interesting 
when you derive a new class from the empty base class. In 
my test program, I have a derived class with the following 
definition: 

class B : public A { 
public : 

B( char *name ) : b( name ){} 
buffer b; 

1 : 

The buffer class (see Listing 1 for its definition) is basically a 
pointer, so under a 32-bit compiler (or large model 16-bit) it 
takes up four bytes. This means that the size of class B should 
be five bytes, right? Well, it is with Borland's C++ compiler, 
but all the versions of Visual C++ I have on hand agree that 
the size is four. The following code: 


Mark Nelson is a programmer for Greenleaf Software in Dallas, Texas. Mark is the author of The C++ Programmer's Guide to the 
Standard Template Library, from IDG Books, as well as The Data Compression Book, from M&T Books. You can reach Mark on the 
Web at http://web2.airmail.net/markn. 
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Listing 1 bug0796.cpp — The no-data assignment bug 


// 

// BUG0796.CPP 
// 

// This program demonstrates a problem that 
// shows up in Visual C++ 4.0 and earlier. 

// When VC++ generates a default assignment 
// operator for class B, it performs a binary 
// copy of exactly one byte. Unfortunately, 

// it hasn’t allocated space for that one byte 
// in the base class, so it inadvertently 
// writes over a single byte in its only 
// data member before calling the data 
// member's assignment operator. In this 
// program, the result is that the buffer 
// member has been mangled, resulting in 
// a copy to an invalid destination. 

// 

//include <iostream.h> 

//include <iomanip.h> 

//include <string.h> 

class buffer { 
public : 
char *p; 

buffer! char *name ) { 
p - new chart 257 ]; 
cout « "in ctor p - " 

<< hex 

« (void *) p 
« ", name - " 

« name 


Milk 


Full-Text Indexing and Retrieval 
Development Toolkit! 


Powerful 

Unlimited document size and quantity 
Full control of document parsing 
Keyword, Boolean, Wildcard 
Phrase, Proximity 
Paraphrase, Delimited Search 
Multi-level nested expressions 

Dynamic 

Full multi-user support 

Works with LAN, WAN, and Internet 
Simultaneous indexing and retrieval 

Efficient index base tuning 


Portable 

DOS, Windows (3.1, NT, 95), 
OS/2, Macintosh, NeXT, Unix 

(7C++, VB, Delphi, and 

Unicode, Asian, and European 
character support 


Fast 

Unequaled indexing speed 
Fast complex searches 
Find the EXACT location of a search 
Perfect for CD-ROM Applications! 


ere 

Enhancing the accessibility of informationI 

PO Box 225, Pleasant Grove, UT 84062 
(801)221-5902 Fax (801) 221-5903 
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« "\n"; 

strcpy( p, name ); 

} 

buffer &operator-( const buffer &that ) 

{ 

cout « "buffer:toperatoi—( that ) " 
« "that.p - " 

« hex 

« (void *) that.p 

« ", " 

<< that.p 
« endl; 
cout « " 

« "this->p - " 

« hex 

« (void *) p 

« ", " 

« P 
<< endl; 

strcpy( p, that.p ); 
return *this; 

} 

~buffer() { delete[] p; } 


class A { 
}; 


class B : public A { 
public : 

B( char *name ) : b( name ){} 
buffer b; 

}; 


mainO 

{ 


cout << "Even though A has no data members, it\n" 

« "still has to occupy a minimum of one\n" 

« "byte according to the C++ standard.\n" 

« "Class B has a single pointer, so under a\n" 
« "32 bit programming model, it should be\n” 

« "exactly four bytes larger.\n" 

« "Unfortunately, VC++ forgets to add that\n" 

« "extra byte from the base class:\n\n"; 

cout « "sizeoft A ) - " « dec « sizeoft A ) 

« " " 

« "sizeof( B ) - " « dec « sizeoft B ) 

« "\n\n"; 

cout « "As the two constructors are called, note\n" 
« "the addresses of the two memory buffers\n" 

« "that have been allocated for the names\n" 

« "of the objects:\n\n"; 

B bl( "object bl" ); 

B b2( "object b2" ); 

cout « "\nWhen the assignment operator is\n" 

« "invoked, the buffer values for this and\n” 

« "that should match what you see printedkn" 

<< "out from the constructors:\n\n"; 

char *mark - b2.b.p; 

b2 - bl; 

if ( mark — b2.b.p ) 

cout « "\nNo bug detected!\n" 

« "Expect a safe exit.\n" 

« endl; 

else 

cout « "\nSince the pointer has been mangled,\n" 
« "expect a GPF upon exit!\n" 

« endl; 

return 1; 

} 

//End of File 
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cout << "sizeof( A ) = " << sizeof( A ) 

« " " 

« "sizeof( B ) - " « sizeof ( B ) 

« "\n\n": 

generates this output: 

sizeof( A ) = 1 sizeof( B ) = 4 

The compiler could probably work around this incongruity. 
Unfortunately, Visual C++ doesn't manage that trick. In fact, 
it does just the opposite. 

How Space Saving Breaks Assignment 

class B contains a single data member named buffer b. 
The buffer class is a simple class with a single character 
pointer member used to hold a name string. When I create an 
object of type B, I initialize the buffer member with the name 
of the object. 

If you don't supply an assignment operator for a class, the 
C++ compiler will generate one for you. For classes such as 
buffer, this is undesirable, because you want to perform your 
own memory management. Therefore, I created an assign¬ 
ment operator to perform a simple string copy, replacing the 
pointer copy that the compiler would have generated. This 
means that I want to perform a deep copy instead of the 
default shallow copy. 

This fact becomes interesting when you perform an assign¬ 
ment operation between two objects of type B. Since I haven't 
created an assignment operator for type B, my test program 
will instead use the compiler-generated function, which does 
two things: 

• It invokes the assignment operator for the base class, A. 

• It calls the assignment operator for the data member, b. 


J SDK Annotation #123 

TYPE: Win16 

TOPIC: LB_SELECTSTRING 
KEYWORD: LB„SELECTSTRING 

win31wh.hlp fails to mention that this message 
works only with single select listboxes. For 
multi-select listboxes it returns LB_ERR. 

Submitted by Dino Esposito. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 


Figure 1 Output from buggy code 


Output from BUG0796.CPP: 

Even though A has no data members, it 
still has to occupy a minimum of one 
byte according to the C++ standard. 

Class B has a single pointer, so under a 
32 bit programming model, it should be 
exactly four bytes larger. 

Unfortunately, VC++ forgets to add that 
extra byte from the base class: 

sizeof( A ) - 1 sizeof( B ) = 4 

As the two constructors are called, note 
the addresses of the two memory buffers 
that have been allocated for the names 
of the objects: 

in ctor p - 0x00650540, name - object bl 
in ctor p - 0x00650648, name - object b2 

When the assignment operator is 
invoked, the buffer values for this and 
that should match what you see printed 
out from the constructors: 

buffer::operatoi—( that ) that.p - 0x00650540, object bl 
this->p - 0x00650640, 

Since the pointer has been mangled, 
expect a GPF upon exit! 
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This is where things get fouled up. Remember that the assign¬ 
ment operator for the base class copied a single byte at offset 
0 from the source to the destination. Unfortunately, the com¬ 
piler has overlaid the buffer member at location 0 to save 
space. So the base class assignment operator wipes out the 
low byte of the character pointer stored in that location! 

My test program, bug0796.cpp (Listing 1), demonstrates 
this bug by performing a simple assignment between two 
objects of type B. You will see that the buffer member of 
object b2 has its lower byte mangled by the base class opera¬ 
tor. You can also verify that this code works properly with 
other PC compilers. This program is a bit lengthy, because I 
tried to provide a lot of detail about what happens inside the 
program as it runs. The program output (see Figure 1) should 
also help clarify matters. 

Summary 

At the beginning of this column, I mentioned that I was 
looking forward to some interesting bugs unique to Visual C++ 
4.0. As it turns out, this particular bug goes way back, at least to 
Visual C++ 1.5, and it also appears in the Visual C++ 4.1 "sub¬ 
scription" update. So how has it avoided detection so long? 

Two things conspired to conceal this bug from detection. 
First, creating a base class with no data members is unusual. 
Second, to be size 0, a class can't contain any virtual func¬ 
tions, which makes it even more unlikely. Finally, even if you 
do succeed in creating a 0-byte class, there is a good chance 
that the assignment operator for any derived class will hide 
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any mistakes the compiler makes. The only reason my test 
program spotted the error was that it didn't do a member¬ 
wise copy of the derived class. Instead, it expected the point¬ 
er member to remain constant throughout the life of the 
object. 

Microsoft's John Browne responds: It's a bug. The commit¬ 
tee is still discussing this behavior; we will probably wait 
until the debate crystallizes before fixing so we don't later 
break people's code. 

Our thanks goes to Timo Kettunen for the bug report. 
Timo will be happily wearing a new WDJ t-shirt during those 
long summer days in Finland. Even if you don't get 18 hours 
of daylight on the summer solstice, you'll still look sharp in a 
WDJ tee. You can pick one up if your bug is used in this col¬ 
umn. Just send bugs to wdl etter@mfi .com and we'll do the 
rest! O 
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TYPE: Win32 

TOPIC: AdjustWindowRect 
KEYWORD: AdjustWindowRect 

The documentation for AdjustWindowRect() 
and AdjustWindowRectEx() has a number of 
problems. 

1. Though the documentation says that window 
titles and borders are not taken into account, 
their function does account for these styles. 

2. Add 1 to the rect.bottom returned by this 
function. There is a one-off error in the y 
direction. 

3. The meaning of the rect parameter is not well 
explained. The input to AdjustWindowRectEx 
is the window coordinates of the top-left and 
bottom-right corners of the desired client 
area. AdjustWindowRectEx inflates the 
specified rectangle to include the caption, 
border and other non-client objects specified 
by the style parameter. 

Reference: MSDN Dr.GUI #10 - Calculated 
Client Window Size. 

Submitted by Etay Szekely. 

Get the entire set of annotations from www. wdj. com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


Win32 System Services, Second Edition 
Marshall Brain 
866 page 

Prentice Hall, 1996 
$49.95 

ISBN 0-13-324732-5 



[Editor's note: this review was provided by Paula Tomlinson.] 
This is the second edition of Brain's Win32 System Services, but 
in this latest edition the subtitle has been extended from The 
Heart of Windows NT to The Heart of Windows 95 and Windows 
NT. I've reached for Brain's first edition often enough to con¬ 
sider it an important part of my technical library. Because it 
covers so many topics, it's usually not the book I rely on to be 
the most comprehensive on any given subject. Rather, it's the 
book I use when it's been several months since I've used 
named pipes, for example, and I want to quickly find some 
reliable sample code to get started. 

Because I found the first edition useful, I was a bit con¬ 
cerned that the second edition might be watered down by the 
addition of Windows 95 coverage. I was also hopeful that per¬ 
haps some of the very useful new features of Windows NT, 
like 1/O completion ports, would have been added to the sec¬ 
ond edition. Neither my fears nor my hopes were realized. If 
you did a di f f of the contents of the first and second editions 
of this book, it would amount to about five new pages of 
information. Half of this information is in section 1.8. In the 
first edition, section 1.8 was entitled "A Brief History of 


Windows NT"; in the second edition, it's been changed to 
"Differences between Windows 95 and Windows NT." All the 
original material is still there, but several additional pages of 
information describe which major topics in the book do not 
apply to Windows 95. The remaining changes consist of brief 
"compatibility notes" scattered throughout the book (at the 
beginning of chapters or major topics within chapters). Since 
this book was originally written about Windows NT and the 
content has not been changed, the compatibility notes flag the 
topics that are not supported on Windows 95. In some cases, 
this applies to entire chapters (e.g., the Services and Security 
chapters), but in other cases, it is more complex. For instance, I 
found the compatibility notes in the RPC chapter the most 
helpful, since Windows 95 supports some — but not all — of 
the features that Windows NT supports. Nothing in the book 
applies to Windows 95 only. 

If you're reading this book specifically to learn the differ¬ 
ences between system services on NT and Windows 95, then 
you'll have to be careful. Not all the references to NT-specific 
entities were edited out or noted. For example, in the first 
chapter, the following statement was carried over from the 
first edition: "Your program will also take advantage of multi¬ 
ple processors on machines that have them." This, of course, is 
true for NT but not for Windows 95. In all fairness, the author 
mentions this difference between the platforms in at least two 
compatibility notes that appear later in the book. Since these 
compatibility notes were apparently meant to qualify all other 
statements made throughout the book, their purpose would 
be more clear had they been printed as sidebars or made to 
stand out more distinctly from the other text in some way. 

Even though I was disappointed that there is nothing actu¬ 
ally new in the second edition, nothing was removed either, so 

continued on page 66 


Got an opinion about these or other programming books? Send them to 70302.2566@compuserve.com. You can order any of the books 
that appear in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing (913) 841-2624, or sending email to 
rdorders@rdpub.com. If using fax or email, send the book title, author, and publisher along with your MasterCard or Visa number, expi¬ 
ration date, and phone number. 

To submit books for review, send them to: Ron Burk, 13846 NE 60th Way, #120, Redmond, WA 98052-4542. Please do not send press releases to 
this address. 
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continued from page 63 

all the things I liked about the first edition are still there. Each 
chapter tends to be a very readable introduction to the topic, 
with relevant sample code. The chapter on services, for exam¬ 
ple, is a very good introduction to services. The section on inter¬ 
active services is weak, though; I wish the author had added a 
little more information, since this is a crucial issue for many ser¬ 
vice writers. Information on just what it means to run under the 
"LocalSystem" account would also have been useful. 

If you already have the first edition, it's not worth upgrad¬ 
ing to the second edition. But if you don't have either book, I 
would definitely recommend picking up a copy of whichever 
edition you can find in your bookstore. This is especially true 
for Windows NT developers, since information on topics like 
services and security is scarce. 


Teach Yourself CGI Programming with Perl in a Week 
Eric Hermann 
512 pages 

Sams.Net Publishing, 1996 
$39.99 (includes CD-ROM) 

ISBN: 1-57521-009-6 
http://unvw.mcp.com/samsnet or 
http://www.practicaTinet.com/cgihook 
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[Editor's note: this review was provided by Victor Volkman, 
www.HAL9K.com.] Teach Yourself CGI Programming with Perl in a 
Week, by Eric Hermann, is the latest edition in the SAMS.Net 
books about the Internet. (This would be a large undertaking 
for a week, considering that the book comprises 520 pages and 
includes a CD-ROM.) The Common Gateway Interface (CGI) 
is a fancy name for the mechanism by which the WWW 
browser and server exchange data via HTML and assorted 
environment strings. For example, CGI allows you to fill out a 
query form on a web browser, send the results to the web serv¬ 
er, have the web server perform various online tasks for you 
(e.g., text search or shopping), and, finally, return some 
results. CGI programming accounts for nearly all of the back¬ 
end web development through the end of 1995 and will con¬ 
tinue to grow through the next several years (Java and com¬ 
petitors notwithstanding). Perl is an interpreted shell scripting 
language similar to Basic with a lot of dynamic list manage¬ 
ment features. 

Though neither CGI nor Perl necessarily has anything to 
do with Windows programming, a lot of web servers are 
being deployed under Windows 95 and NT. These new plat¬ 
forms thus can stand to inherit quite a lot from the UNIX envi¬ 
ronment, which was the original domain of web servers. My 
own experience with the CGI, Perl, and the Alibaba Webserver 
for Windows 95 has proven very viable. 

The book covers most aspects of the CGI, including decod¬ 
ing queries, server-side includes (SSI), forms, image maps, 
access counts, generating HTML pages, and security-related 
issues. These are arbitrarily divided into 14 chapters, which 
are in turn assigned to "Day One" through "Day Seven," in 
case you have trouble remembering. I found the technical con¬ 
tent to be good, but the pacing is atrocious. The first three 
chapters supply a lot of esoteric background information that 
I eventually found I didn't need to know, and I felt lost until I 
got to the part on using forms (around page 100). The next 
major technical topic, image maps (graphics with hot spots), 
didn't get underway until more than halfway through the 
book. My main complaints are that the CGI pacing was too 
slow and that the Perl was too fast. I found that I needed to 
keep a copy of Programming Perl, by Wall and Schwartz, 
handy when I actually went to write my own Perl scripts 
(www.ora .com/www/item/pperl.html ). The plunge into object- 
oriented Perl in Chapter 8 occurs without any additional back¬ 
ground. 

I found the CD-ROM less than helpful and a prime exam¬ 
ple of what I believe Ron Burk has classified as "nothing- 
ware." It contains examples from the book, a copy of Perl 4 
and 5, five popular web libraries, and WinZip. The combined 
total fills less than 8Mb. The remaining space should have 
been used to either hold a copy of the book or include some 
web servers. As it was, I found Perl on the CD-ROM to be 
unusable, since it didn't include an MS-DOS executable and 
the makefiles were inscrutable (never mind the fact that the 
book didn't say you needed a C compiler to build the imple¬ 
mentation of Perl included on its "DOS/Windows/Unix CD- 
ROM"). After a bit of web scavenging, I was finally able to 
locate a pre-built version for MS-DOS 
(ftp://oak.oakland.edu/SimTel /ms dos/per 1 / bperl4x.zip). 
This version worked very well with the Alibaba web server. 
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which I had previously been using solely for its HTML-serv- 
ing powers. 

Advice on security issues is included in the text wherever it 
applies to the current subject. I found a lot of the advice overly 
biased towards UNIX with its quirky shell escape artistry, the 
inherent vulnerability of hosting a web server on a machine 
that users can telnet to, and filesystem protection issues. Again, 
running my web server on Windows 95 made these arguments 
void, because my PC doesn't export filesystems and is not a tel¬ 
net server. I have no doubt that web security issues will contin¬ 
ue to haunt us for the foreseeable future, but these are either 
inherently UNIX issues or relate to the vulnerability of sending 
unencrypted data over the public Internet. 

Chapter 9, on image maps, provides the type of content I 
most expected to find. This section works through several 
examples using a world map as the image. In doing so, it cov¬ 
ers irregular hot spots and the semantics of overlapping hot 
spots. Chapter 10, on keeping track of web page visitors, is 
mainly a hodge-podge of references to various available free¬ 
ware statistics. Of course, finding the right freeware access 
counter can save you valuable time. Chapter 13, on debug¬ 
ging, adds little to the existing discussion, exhorting you to 
use the print command to display output and offering plati¬ 
tudes such as "Don't give up." 

Teach Yourself CGI Programming with Perl in a Week will help 
you move beyond simple HTML authoring and into the realm 
of web-server backend applications. Its coverage of Perl fea¬ 
tures is just enough to get you used to using the language. 
Many of the advanced Perl features (such as the database 
library) are given short treatment. If you're looking for how-to 
information, don't ignore the Internet itself. There are many 
excellent resources on the WWW; you might want to start 
with "The Web Developer's Virtual Library" 
(http://www.stars.com). 


Steal This Code! 

A1 Williams 
357 pages 

Addison-Wesley, 1996 
$34.95 

ISBN 0-201-40998-4 



Regular WDJ readers are aware of my long-running diatribe 
against programming books that impose absurd legal restric¬ 
tions on the code they contain. Therefore, given a book with the 
title "Steal This Code!", my first priority was to determine 
whether or not you would literally have to steal the code to 
make use of it, as is the case with so many books. The code disk 
contained a copyright label, so I was anticipating the worst. 
However, the disk itself contained a "readme" file with a simple 
but effective grant of rights: basically, you can use this code so 
long as you don't distribute the source code and you agree not 
to sue if the code has defects. Now, was that so hard? 


Apparently, it is exceedingly hard, since most program¬ 
ming books from every publisher I can think of (Addison- 
Wesley, Prentice Hall, Microsoft Press, SAMS, WROX, etc.) 
contain a cover touting the value of the code inside, along 
with a legal booby trap buried in the back of the book that pre¬ 
vents you from making reasonable use of the code. Therefore, 
I want to take a moment to congratulate A1 Williams, Claire 
Horne (sponsoring editor), John Fuller (project manager), and 
Ellen Savett (production coordinator) for whatever role they 
played in this unique accomplishment. Unfortunately, I can't 
congratulate the publisher (Addison-Wesley) as a whole, since 
they publish plenty of other books with the traditional legal 
bait-and-switch feature. However, I can always hope that this 
is the beginning of a trend. If any publisher announces a blan¬ 
ket no-more-legal-mumbo-jumbo policy for the code in their 
books, I will certainly pass that news along to readers here. 

In varying degrees of detail, the book covers window sub¬ 
classing and superclassing, custom dialog classes, many of the 
Win32 common controls (image lists, status bars, toolbars, 
listviews, treeviews), tabbed dialogs, and the author's home¬ 
grown application framework, which helps you quickly create 
Windows applications with a certain core functionality. The 
thread that weakly binds the various pieces of this book is the 
idea that you can reuse existing code in Windows in a variety 
of ways. Like most books, this one gamely takes a swing at 
topics well beyond its grasp; for example, there's a 20-para- 
graph overview of OLE that is unlikely to help anyone. 
Though the book's code is designed to be compatible with 


THE 


MERjzxr 


SUITE 


The complete toolset for on-line authoring 


HWA + HLPDK/PA + Interactive Help + OSHTools + 
Hyperimage = The ultimate on-line authoring tool 
for Windows, Windows95, OS/2 and WWW HTML ! 


• Import existing help files (.hip) and HTML files (.html) for editing! 

• A full feature true WYSIWYG Visual editor with a power topic tree and an image editor. 

• Automatic Internet World Wide Web HTML and OS/2 IPF generation! 

• Interactive forms, dialogs, dynamic topics, embedded video clips, 
control WinHelp events, 
and more. 


Order 

The Hypertext 
Suite today 
for just $ 375 ! 



Welcome to 
The HyperText Suite 


taimitttdliuL UlOIwcl 

Software products 
Introduces you to the 
products that Olson 
SoSwhre produce «nd how 


o w lo Order Olson Sollwate pi 


Hypertext 
Introduces you to the 
concepts of HyperText 
md how Olton Sottwere 
products use these 


HyperActJ 



3437 335th St. West Des Moines IA 50266, USA 
Phone: (515) 987-2910 Fax: (515) 987-2909 
Internet: rhalevi@hyperact.com 
CompuServe 76350,333 

http://www.hyperact.com 


July 1996 


j Request Reader Service #159 □ 

Windows Developer’s Journal — Page 67 




































J SDK Annotation #125 

TYPE: MFC 3.1 and 3.2 
TOPIC: ClmageList::DeleteObject 
KEYWORD: DeleteObject ■/ 

VC++ 2.1 and 2.2 help files incorrectly 
documented this function to delete image 
lists, while it actually never existed. The 
correct function to delete an image list is 
ClmageList::DeletelmageList(); it returns 
non-zero if successful and zero if it fails. 

This error is corrected in the VC++ 4.0 
documentation. 

Submitted by Barry Tannenbaum. 

Gel the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 



either Borland or Microsoft compilers, the book itself often 
contains MFC asides, which will be welcomed by MFC users 
but not by Borland programmers. 

This book is not a shining example of technical clarity, either 
conceptually or at the nuts-and-bolts level. For example, one 
passage explains that a Windows window class "encapsulates 
all the information Windows needs to create a window and 
define its behavior," when in fact the typical window class 
encapsulates remarkably little of use beyond the window pro¬ 
cedure; most of the information needed to create a window 
must come through CreateWindow( ) or CreateWindowExf ). The 
author says that to make window classes available to all appli¬ 
cations, you must use the CS_GLOBALCLASS style. In fact, Win32 
has completely changed the meaning of CS_GLOBALC LASS — it 
makes a window class visible only to other modules in the same 
process. The author claims you can define a custom message 
either by adding a constant to WM_USER (he fails to note that 
WM_APP is sometimes the more appropriate choice) or by calling 
RegisterWindowMessageO, but he then implies that neither 
method will produce a constant that can be used in a switch 
statement. The author says that it is a limitation of MFC that 
two threads can't access the same instance of an object at the 
same time. This is two misleading statements in one: the need 
to synchronize thread access to data structures is not an MFC- 
specific problem (or even an object-oriented problem), and syn¬ 
chronization is by no means necessary in all cases (e.g., read¬ 
only data). 

Does the code actually work? I installed it and set out to 


build the editor example in Chapter 7. It was unfortunate that 
the author did not compile with STRICT defined, since that can 
help detect a variety of type errors in calls to the Windows 
API. Some futzing was required due to hardcoded paths in the 
makefile, but other than that it was a clean and easy build and 
I found no problems. The code seemed to be in better shape 
than that typically found in code-oriented programming 
books. 

If you're looking for lots of examples of how and when to 
subclass and superclass windows, this book is a good choice. 
It might also be worth a read if you're making your own 
homegrown application framework. Beyond that, I can't rec¬ 
ommend it; the prose is not highly accurate, and you can learn 
as much about the new common controls from the SDK docu¬ 
mentation as from this book. 


README.1ST 

SGML for Writers and Editors 

Ronald C. Turner, Timothy A. Douglass, 

and Audrey J. Turner 

241 pages 

Prentice Hall, 1996 

$45.00 

ISBN 0-13-432717-9 


As the bookstores bloat with books on Java, HTML, CGI, 
Perl, and most anything with the word "Web" in the title, 
here's a book that doesn't seem to be about any of those hot 
topics, but actually has some hidden relevance. SGML stands 
for Standard Generalized Markup Language, and is a high- 
level standard for creating portable, structured documents. 
Perhaps you have already learned what non-portable docu¬ 
ments are, by writing program documentation in WordStar 
that then could only "sort of" be imported into Microsoft 
Word, which in turn could only "sort of" be imported into 
Microsoft Word for Windows (which initially did not support 
crucial features like character styles). And any tools you wrote 
to manipulate the documents (e.g., print out the title line of all 
the function definitions in a specification) likely became use¬ 
less when you moved to a new word processor. Wouldn't it be 
nice if there were a simple but flexible document format that 
was portable and standard enough that many third-party 
companies could make tools for it? 

SGML is a standard (more well-known outside the PC 
world) that lets you identify the structural elements of your 
document (e.g., function name, topic keywords, operating 
system platform); it is general enough that it can be applied 
to most any kind of document. In fact, HTML (the hypertext 
format used to describe Web pages) is a specific application 
of SGML (though it continues to diverge from SGML). The 
book includes a chapter on HTML, but you can find other 
books that provide more complete descriptions. What this 
book offers is an understanding of where HTML fits into the 
larger framework of portable documents. If you are involved 
in strategic decisions about how your company stores its 
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technical documents, consider reading this book first. As 
HTML shows, SGML applications can often end up in the 
domain of programmers, since structured documents benefit 
from software tools for creating, viewing, and searching them. 

Let's Talk Books 

From: Maureen O'Toole 
Subject: Excerpting 

An excerpt of your book published in a trade magazine is 
an effective way to generate early enthusiasm (and ultimately 
sales!) for your book. Excerpts of Addison-Wesley Developer 
Press titles have been published in leading magazines, includ¬ 
ing PC Computing, Datamation, and EDN. 

We require that magazines either trade advertising space 
or submit payment for the excerpt. It is imperative to involve 
Addison-Wesley as soon as the publication confirms space for 
the sample chapter(s). Many times magazine editors take it 
upon themselves to publish material without compensating 
the publisher. Not only is this illegal, but it does not allow us 
to maximize publicity for your book. 

If you choose to contact a publication yourself, please keep 
[the publicity director] informed. At that time we can discuss 
how and when electronic files will be sent for the chapters 
agreed upon by the publication. 

Thank you in advance for your help. 

This email message left me first confused and then bemused; 
apparently, my name ended up on a mailing list of Addison-Wesley 
authors, offering me some free insight into what publishers tell 
authors. I'm somewhat dubious about the idea that many editors will 



J SDK Annotation #126 

TYPE: Win32 
TOPIC: AVIFileOpen 
KEYWORD: AVIFileOpen 

The documentation specifies that using the 
OF_CREATE flag will cause an existing file to 
be truncated to zero length. In reality, it has no 
effect: the file length remains the same, and the 
old data is intact once the file is closed. 

Submitted by Tim Lesher. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “Ft&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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publish copyrighted material illegally; nearly all the magazines I 
know of require the person who submits the material to sign an agree¬ 
ment stating that they have the legal right to sell the material. Which 
raises another interesting point — are book authors really signing 
contracts that give the publisher the copyright? If so, why? As far as 
I know, it's usually not that difficult to negotiate a book contract that 
gives the author the copyright and all revenues from things such as 
magazine excerpts. Given what a tiny portion of the revenue pie goes 
to most programming book authors, it seems only right that if the 
author can manage to sell an excerpt to a magazine, the author should 
get the revenues for it. That's one reason why, as an editor, I usually 
flatly turn down any inquiry from a publisher about excerpting one of 
their books. We almost never excerpt books anyway, but when we do, 
I want the money to go to the person who actually worked to create 
the material. 

Anyway, it certainly is a vicarious thrill getting email from pub¬ 
lishers intended for book authors. Hopefully, no one from Addison- 
Wesley reads this column and I will continue receive their email mis¬ 
sives for programming book authors! —rib 

Dear Mr. Burk, 

I would like to warn fellow WD] readers about a book that 
I purchased. DirectDraw Programming by Bret Timmins (M&T 
Books, 1996) was a huge disappointment. First, the book 
seemed to imply that Microsoft's Game SDK is included on 
the accompanying CD-ROM by discussing how to install it in 
the first few pages. Nowhere does it state that the Game SDK 
must be obtained separately. (As far as I know, it is still only 
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J SDK Annotation #127 

TYPE: Win16 
TOPIC: CBTProc 
KEYWORD: CBTProc 

The CBTProc documentation fails to mention 
that you can return 0 to allow the operation and 
1 to prevent it for HCBT_SETFOCUS 
notification also. The documentation has been 
corrected in the Win32 help file. 

Submitted by V. Ramachandran. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 


available as part of a Microsoft Developer's Network sub¬ 
scription, for $495 per year.) The other two books I looked at 
about programming DirectX games both explicitly state that 
you need the Game SDK. Second, two of the four "Advanced 
Direct Draw Topics" listed on the back of the book simply do 
not exist in the book or on the CD-ROM. According to the 
back cover, the author was supposed to develop sprite and 
tiling classes, but I guess they just forgot to include those 
chapters. Or maybe there wasn't enough room after devoting 
nearly one third of the book to a DirectDraw reference and 
repeating identical, multi-page functions in several chapters. 
Finally, the author's sample program "Knob," which is 
included on the CD-ROM, was supposed to be used in the 
book to "explore the inner workings of DirectDraw." Again, 
not a single word in the book about it. 

After reading the book (which didn't take long with such 
little content) and not finding these topics covered, I was quite 
upset. Fortunately, I was able to call the Barnes & Noble book¬ 
store where I purchased the book and they agreed to send it 
back to the publisher and refund my money. I enjoy reading 
"Books in Brief" and have found the reviews and letters to be 
very useful. I hope this letter can help your readers who are 
interested in purchasing a DirectX/Game SDK book. 

Sincerely, 

Michael Tullius 

You are right that the book jumps into detailed instructions on 
how to install the Microsoft Game SDK and the instructions are 
worded such that it is very easy to assume that they mean the SDK is 
on the CD-ROM in the book. I was unable to find any mention in the 
book of where you really can obtain the SDK, which contributes to 
this misleading impression. You are also right that the book was 


padded by adding over 100 pages of raw API documentation, for¬ 
matted with huge amounts of white space in a clear attempt to make 
the book thicker than it deserves to be — a special Slayer of Trees 
award goes out to M&T Books for that one. You are right again when 
you say that the back cover promises "topics" that do not appear in 
the index, let alone in the book. This is not a book anyone can feel 
good about having paid $39.95for. 

Although I'm no longer surprised at the poor quality of program¬ 
ming books, I was pleasantly surprised to hear that Barnes & Noble 
stood up for the consumer in this transaction. Most bookstores, be 
they large or small, seem to be quite unwilling to refund your money 
if you have touched that diskette or CD-ROM in the back of the book. 
This is a Catch-22 — sometimes you can’t know you're being ripped 
off until you fire up the actual software the book promised was so 
wonderful, but if you open the package, you lose the ability to return 
the book. I can understand the bookstore being afraid that people will 
steal the software and return the book, but I think that fear is 
unfounded. First, in the programming book market, 95 percent of the 
code is literally not worth stealing. Second, programming books are 
quite expensive, and most of the folks who buy them buy multiple 
books each year. A bookstore looking for maximum profits would do 
well to make this small but highly profitable group of customers feel 
that they can buy programming books with the same assurance that 
they purchase most any other $50 item at a store — the assurance 
that it can be returned if it turns out to be seriously flawed or unsuit¬ 
able for its stated purpose. Kudos to your Barnes & Noble branch 
and thanks for sharing your opinion on this book with our readers. If 
anyone knows of other bookstores with enlightened policies for pro¬ 
grammers, let me know and I'll see if we can give them a free plug 
here. —rib 

Ron, 

Regarding the quest for the holy MFC book: Microsoft 
Press just released Programming Windows 95 with MFC by Jeff 
Prosise. I just received a flier on it in the mail; one side was for 
the new Petzold, the other for this. It was billed as the Petzold 
of MFC! As we both know, searching for a good MFC book has 
proven quite fruitless. Could you get your hands on this and 
let the masses know if this book changes that trend? We 
would all appreciate it. 

Thanks, 

Tom B. 

Jeff also noted the great search for a really good MFC book and 
has promised to deliver one of the first copies of his new book when it 
rolls off the press. I'm trying not to be prejudiced by the fact that he 
wrote one of the better books on using C++ with Windows 
(Windows++, part of the Andrew Schulman programming series), 
but it's hard not to be hopeful. I'll try to get a review in as soon as I 
can after the book arrives. —rib □ 
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Industry-Related News and Announcements 


Send your press release 
to Miller Freeman, Inc. 
1601 W. 23rd St. 
Suite 200 
Lawrence, KS 66046 
fax 913-841-2624 
wdletter@mfi.com 


Rogue Wave Updates Tools.h++, Standard C++ Library 


Rogue Wave Software is shipping an 
enhanced version of Tools.h++ that provides 
an object-oriented interface to the Standard 
C++ Library and extends it with new collec¬ 
tion classes. Five new collection classes 
include a singly linked list, hash-based map, 
hash-based multimap, hash-based set, and 
hash-based multiset. New persistence fea¬ 
tures let developers store and retrieve tem¬ 
plate classes and make custom classes persis¬ 
tent without having to inherit from a Rogue 
Wave root class. The regular expression 
package is now POSIX-compliant and han¬ 
dles expressions of arbitrary length. New 


template classes include a double-ended 
queue, tree-based set, and sorted doubly 
linked list. Endian streams provide a 
portable binary format for exchanging data 
between different environments. 

Tools.h++ v7.0 costs $395; technical support 
and updates for one year cost $195. The 
Standard C++ Library costs $195; maintenance 
for one year is $195. For more information, 
contact Rogue Wave Software, 260 S W 
Madison Ave., Corvallis, OR 97333; (503) 754- 
3010; fax (503) 757-6650; 
www.roguewave.com. 


OCX Provides AutoCAD Viewing!Printing 


AcademusView VBX/OCX for Windows is 
a new library that offers royalty-free support 
for viewing and printing AutoCAD drawing 
files from Visual Basic. The basic version 
supports viewing AutoCAD (versions 2.5 
through 13) DWG files and R13 bitmaps and 
metafiles, SFfX font support, optional use of 
AutoCAD solids, optional support for attrib¬ 
utes and polylines with width, configurable 
32-bit display list that supports sizes up to 
16Mb, both model- and paper-space draw¬ 
ings, and x-ref support. The professional ver¬ 
sion adds support for vector zoom and pan, 
a zoom window and directional pan support 
with optional rubberband, the ability to 


print/plot a drawing or section to any 
Windows printing device, the ability to copy 
a drawing or section of a drawing to the clip¬ 
board as a metafile, a separate Picture prop¬ 
erty for a bitmap copy of the viewed draw¬ 
ing, and a regeneration command to enhance 
the quality of zoomed drawings. 

AcademusView VBX/OCX costs $299 or 
($1999 for the professional version) and 
supports Windows 3.lx, Windows 95, and 
Windows NT. For more information, con¬ 
tact Academus AS, P.O. Box 70 Bogerud, 
N-0621 Oslo, Norway, +47 22627300; 
fax +47 22627492; academus@academus.no; 
www.riksnett.no/acadernus. 
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ActiveX Control Supports 3D Graphics and VRML 


Template Graphics System has introduced 
Visual 3Space Browser Control, an ActiveX 
control to support 3-D graphics and the 
Virtual Reality Modeling Language (VRML) 
standard. VRML is an Internet file format that 
allows the linking of local and remote data 
within 3-D scenes and objects. ActiveX con¬ 
tainer applications can use the Visual 3Space 
Browser Control to view Open Inventor and 
VRML Internet files. The Pro Edition of the 
control lets Visual C++ or Visual Basic pro¬ 


grammers customize the control for specific 
applications. 

The TGS Visual 3Space Browser Control for 
ActiveX container applications costs $99 in the 
U.S. and $125 internationally. The Visual 
3Space Browser Control Pro Edition costs $495 
or $600 internationally. For more information, 
contact Template Graphics Software, Inc., 
9920 Pacific Heights Blvd., Suite 200, San 
Diego, CA 92121-4331; (619) 457-5359; fax 
(619) 452-2547; ivww.tgs.com; info@tgs.com. 


Toolkit Provides Licensing for PC and UNIX Apps 


LicenseSERV is a floating license toolkit 
for PC and UNIX applications. It supports 
cross-platform applications and is LS-API- 
compliant. LicenseSERV works with TCP/IP 
or IPX/SPX protocols and multiserver net¬ 
works. It supports floating/concurrent and 
node locked licenses; site, group, personal, 
and machine-based licenses; and version- 
controlled licenses. Customers can upgrade 


via phone, fax, or email. 

LicenseSERV prices start at $2,500 for PCs, 
$5,000 for the standard edition, and $7,500 for 
the extended edition. For more information, 
contact Central Design Systems, Inc., 1705 
Wyatt Dr., Santa Clara, CA 95054; 

(800) 366-2347 or (408) 327-9800; 
fax (408) 327-9810; info@cdsi.com; 
www.cdsi.com. 


Eschalon Updates Delphi Control Package 


Eschalon Power Controls 2 is new set of 
controls for Delphi 2.0 applications. A wizard 
control lets developers create a wizard in one 
step; it automatically displays and handles 
buttons, advances through steps, supports 
unlimited pages, and queries pages to see if 
they are done. An animation control lets 
developers select bitmaps, periods, border 
styles, and colors; the control can be used to 
inform users of progress during a lengthy 
process. A bitmap button control provides 
irregularly shaped buttons. A calendar con¬ 
trol provides customizable display and data 
entry for dates; headings, drawings, colors. 


and events can be customized. A visual label 
control displays fonts, styles, sizes, colors, 
and bullets. Additional controls include: hot¬ 
key support for Win95 and NT applications, 
a menu button (like that in Office 95), stan¬ 
dard "Tip of the Day" and "About" forms, 
logical panes for forms, and task bar notifica¬ 
tion icons. 

Eschalon Power Controls 2 costs $149.95. 
For more information, contact Eschalon 
Development Inc., 24-2979 Panorama Dr., 
Coquitlam, BC V3E 2W8 Canada; 

(604) 945-3198; fax (604) 945-7602; 
info@eschalon.com; www.eschalon.com. 


ACUCOBOL-GT Provides COBOL GUI Statements 


Acucobol, Inc. is now shipping ACU- 
COBOL-GT for Windows 3.1, Windows NT, 
and Windows 95. ACUCOBOL-GT lets pro¬ 
grammers create graphical applications 
using COBOL extensions consistent with tra¬ 
ditional COBOL syntax and methodologies. 
Programmers can create windows, edit con¬ 
trols, listboxes, buttons, etc. from within 
their COBOL program. The product allows 


any program written in ACUCOBOL-85 to 
run as a native GUI program without recod¬ 
ing or recompiling. 

ACUCOBOL-GT for Windows prices start 
at $1,250. For more information, contact 
Acucobol, Inc., 7950 Silvertin Ave., Suite 
201, San Diego, CA 92126, (800) 262-6585 or 
(619) 689-7220; fax (619) 566-3071; 
info@acucobol.com; wwiv.acucobol.com. 
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Bristol Updates Wind/U 

Wind/U is a family of products that lets 
programmers build Win95, NT, OpenVMS, 
and UNIX applications from a single source 
code base. The new release of Wind/U fea¬ 
tures support for OLE, MFC v4.1, rich edit 
controls, and support for new versions of 
IBM's AIX 4.1 and Hewlett-Packard's HP-UX 
10 operating systems. Wind/U applications 
can be both an OLE container and an OLE 

DynamiCube OCX Provides OLAP 

Data Dynamics, Ltd. has released 
DynamiCube OCX, an online analytical pro¬ 
cessing (OLAP) 32-bit OLE custom control 
for Windows 95 and Windows NT develop¬ 
ers. DynamiCube works with all data 
sources supported by Microsoft's JET, ODBC, 
and RDO. It provides OLAP views from 
inside any Visual Basic application. 

Developers can create virtual dynamic views 
of their tables without writing any code. 

Other features include: unlimited n-dimen- 
sional views, runtime drag-and-drop data 
pivoting, layout editor with drag-and-drop 


server. Other OLE support includes COM, 
visual editing, OLE automation, OCXs, and 
OLE drag-and-drop. 

Wind/U v3.1 costs from $5,000 to $9,950, 
depending on volume. For more informa¬ 
tion, contact Bristol Technology, Inc., 241 
Ethan Allen Highway, Ridgefield, CT 06877, 
(203) 438-6969; fax (203) 438-5013; 
info @ bristol.com. 


areas and live data, multiple aggregate and 
statistical functions and summary levels, the 
ability to expand and collapse at any sum¬ 
mary level, data filters, custom methods to 
retrieve summarazed data and graph or print 
it, sparse matrix handling, suuport for multi¬ 
ple data items, time series fields, and flexible 
on-screen formatting. 

DynamiCube OCX costs $499. For more 
information, contact Data Dynamics, Ltd., 
2525 Tiller Lane, Columbus, OH 43231; 

(614) 895-3142; 72672.550@compuserve.com. 


Symantec Cafe Offers Java Development 


Symantec Corporation has released a Java 
development environment for Windows 95 
and NT called Symantec Cafe. Cafe provides 
an IDE for Sun's JDK to allow programmers 
to interactively create Java applets for web 
pages. The IDE parses Java source code on 
the fly and provides a visual class hierarchy. 
A class browser lets developers browse and 
edit methods, data, and classes. The 
AppExpress wizard lets developers quickly 
generate a functional skeleton of a Java 
applet, which can then be customized and 
extended. The IDE includes a programmer's 
editor with color syntax and keyword high¬ 


lighting and an integrated macro language. 
The editor can instantly navigate to any Java 
declaration in the current program or Java 
class libraries. 

Symantec Cafe was first available as a 
patch for users of Symantec C++ v7.2 for 
Windows, downloadable from www.syman- 
tec.com. It is now available as a standalone 
product for $299.95; owners of Symantec 
C++ can purchase it for $99.95. For more 
information, contact Symantec Corporation, 
10201 Torre Ave., Cupertino, CA 95014-2132; 
(800) 441-7234 or (408) 253-9600. 


VB Library Provides Multiport Support 


The Personal Communications Library for 
Visual Basic/Windows (PCLVBW) is a new 
library that gives Visual Basic programmers 
access to up to 20 ports using any UART 
address and any IRQ, running at speeds up 
to 115,200 baud. Multiport boards supported 
include those from DigiBoard and BOCA. 
The library is available as shareware from 
the company's BBS or via anonymous FTP 


from ftp.traveller.com (/pub/users/msc). 

PCLVBW costs $75 to register. For more 
information, contact MarshallSoft 
Computing, Inc., P.O. Box 4543, Huntsville, 
AL 35815; (205) 881-4630; fax (205) 880-0925; 
BBS (205) 880-9748; msc@traveller.com; 
www.traveller.com! ~mscl. 
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Vireo Updates VxD Toolkit 

Vireo Software has released a Windows 95 
version of VTOOLSD, their toolkit for VxD 
developers. The toolkit provides code gener¬ 
ation and libraries that allow developers to 
build VxDs using C or C++. The new 
Windows 95 version supports Windows 95 
file system development and includes an 
example that illustrates techniques not treat¬ 
ed in Microsoft's DDK (allocating a new 
drive letter, creating an .inf file, and inter¬ 
facing file system drivers to the IOS). The 
Windows 95 version also provides improved 
communication driver support. The compa¬ 


ny has also shipped an updated version of 
VTOOLSD for Windows 3.1, featuring new 
examples, bug fixes, and a new extended 
help system. VTOOLSD can supplement or 
completely replace Microsoft's DDK. The 
product is compatible with both Microsoft's 
and Borland's 32-bit compilers 

VTOOLSD for Windows 95 and VTOOLSD 
for Windows 3.1 cost $495 each or $695 for 
both. For more information, contact Vireo 
Software, Inc., 21 Half Moon Hill, Acton, MA 
01720, (508) 264-9200; fax (508) 264-9205; 
vireo@vireo.com; http://world.std.com/~vireo. 


timeLOCK! Enables "trialware" Applications 


Dan Bricklin's timeLOCK! is a new tool 
that lets programmers create "trialware" 
applications that give users trial use of soft¬ 
ware for a limited time. The first time the 
application runs, it can prompt the user for 
registration information, then lock the soft¬ 
ware with a unique, time-based code. 
Thereafter, each time the user starts the 
application, a popup window displays the 
evaluatoin time remaining and provides 
information on how to purchase the software 
by calling or emailing the vendor for the 


deactivation key. A separate keycode module 
lets the sales staff provide the unique unlock¬ 
ing key for any given customer. A vendor 
can provide a key that will give the applica¬ 
tion a one-time extension of the evaluation 
period. 

timeLOCK! costs $699. For more informa¬ 
tion, contact Lifeboat Publishing, 1163 
Shrewsbury Avenue, Shrewsbury, NJ 07702, 
(800) 447-1955 or (908) 389-0037. 


Vivid Resolution Offers PowerBuilder RAD 


Vivid Resolution vl.O is a rapid applica¬ 
tion development tool that generates appli¬ 
cations from visual application and data 
models. Users can specify the business rules 
for an application along with data and rela¬ 
tionships, then automatically generate an 
application to PowerBuilder. The tool incor¬ 
porates the data modeling capabilities of 
Vivid Clarity and also allows users to: model 
applications, attach methods and data to 
each process, model visual and non-visual 


objects, define application navigation paths, 
generate prototypes, generate applications 
automatically, and drag and drop objects 
between Object Gallery repositories to share 
objects. 

Vivid Resolution vl.O costs $2,995 with an 
introductory price of $2,495. For more infor¬ 
mation, contact Intek Technologies, Inc., 
5000 Peachtree Ind. Blvd., Suite 150, 
Norcross, GA 30071; (770) 840-2500; 
fax (770) 840-2525; www.intekinc.com. 
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Readers' Forum 


Send letters to wdletter@mfi.com. 


From: "Bruce W. Forsberg" 
<forsberg@cts.com> 

Subject: Readers' Forum letter 
Dear Ron Burk, 

I read with great interest Nigel 
Hooper's letter in the April 1996 issue of 
WDJ. He stated his frustration being a 
hobbyist programmer. I believe he has 
touched on an important issue. The 
computer industry is changing in a way 
that few people realize. It will mean the 
end of the hobbyist programmer. I 
remembered when I started as a kid 
with a TRS-80 model 1 computer with 
16K memory. If you wanted to do any¬ 
thing with this computer you had to 
program. The BASIC language that 
came with these early computers was 
easy to learn and use. Today's comput¬ 
ers though are getting more and more 
complicated. As they get more and more 
complicated software programming is 
getting more and more complicated 
what with GUI's, object oriented design, 
C++, threads, and the like. 

I recently purchased Borland's 4.53 
with CodeGuard and wouldn't you 
know it, several weeks later 5.0 comes 
out that will cost me another $200-300.1 
just can't keep up any more. I feel for 
Nigel and other hobbyist programmers 
like myself. Our days are limited. How 
does a young kid today learn program¬ 
ming when they have to learn C++ and 
Microsoft Windows? That is asking a 
lot. Some will succeed, but many 
instead will just become users of com¬ 
puters instead of programmers. 

Sincerely, 

Bruce Forsberg 

I can see it both ways. The compiler rack¬ 
et has definitely changed, as the pace of 
upgrading means that you are effectively 
paying $300/year for your compiler, not 
really buying a tool that you would own for 
several years. I suspect the kids starting 
today will start with Visual Basic (not super 


cheap, but if they can afford a machine . . .) 
and get along just fine. But there is price to 
be paid for the layer upon layer of complex¬ 
ity being built into Windows. I think 
Microsoft paid part of that price in the form 
of an extremely late Windows 95, an operat¬ 
ing system that they really can't afford to 
issue patches for (you think that "upgrade" 
they issued altered a single bit in the core 
system?) because it’s so fragile. But the bulk 
of the bill is growing and yet to be paid, in 
my mind. Maybe it will eliminate the hob¬ 
byist Windows programmer. 

Along these lines, I note that Microsoft 
recently started selling an "introductory" 
style of Visual C++ at a reduced cost, prob¬ 
ably to compete with Borland's Turbo line. 
Perhaps that means the student/hobbyist 
market is large enough to still hold the 
attention of the big compiler vendors. 
Hobbyists have a habit of persevering when 
sensible people would find a different hobby, 
so maybe the hobbyist programmer is still 
alive and well. —rib 


From karen_wade@non-hp-ftcollins-om4.om 
Subject: WDJ: scrolling while dragging- 
and-dropping 

Your May 1996 issue is my very first 
Windows Developer's Journal. I really 
enjoyed it. I could follow your article on 
drag-and-drop support for MFC 
listviews very well because I recently had 
to code this functionality for a treeview 
(which behaves much like the listview). 
The only difference was that I had to take 
it a step further and code support for 
drag-and-drop scrolling. The treeview 
did not support scrolling the display 
when I tried to drag-and-drop. 

Scrolling the display down was fairly 
easy. The treeview — like the listview — 
supplies certain member functions that 
can be used to verify if the cursor is at 
the top of or above the client area, and 
the view can be scrolled from those 
results. But scrolling up has gotten very 
tricky. When I use the same member 
functions (HI tTest ()) to see where in the 
display I am, the results are not returned 
with the data documented if the cursor is 
at the bottom of the display or below the 


client area. I expected a TVHT_NOWHERE 
(LVHT_NOWHERE for listview) or 
TVHT_BELOW(LVHT_BELOW) to initiate the 
scroll up, but that did not happen — 
instead, I got a TVHT_ITEMLABEL. Right 
now, scrolling down does not work the 
way I want. I tried doing an 
EnsureVisible on the NextVi si bl eltem if 
the NextVi sibl eltem is not NULL. That 
did not work correctly. It scrolls really 
fast and looks bad. Do you have an 
answer? 

Also, why does the Return key close 
the dialog box when I perform an 
EditLabel onaTreeCtrl in a Dialog box? 

I expected an EndLabelEdit so I could 
perform my modifications and contin¬ 
ue. In my opinion, mapping the OnOK to 
catch the Return key and to avoid clos¬ 
ing the dialog box is wrong. I've tried 
mapping the notification messages, the 
command messages, and the NM_RETURN 
message, but nothing works. 

We're usually not a good place to route 
general Windows programming questions; 
like most magazines (even those much larger 
than WDJ), we don't have a technical staff 
equipped to answer them. The best place to 
take such questions is the most active online 
forum you can find where Windows pro¬ 
grammers hang out, such as the appropriate 
Usenet newsgroups, or the Windows pro¬ 
gramming forums on CompuServe. Another 
reason we're a bad choice is that sometimes we 
can't make your return email address work, as 
was the case with your message — by the 
time you read this, I suspect you will have 
already solved your problems! 

If 1 know the answer off the top of my 
head, I will sometimes try to answer gener¬ 
al questions anyway. In this case, 1 don't 
knozv the answer to your first question, but 
your second question certainly sounds like 
a subject covered in "Drag-and-Drop 
Support for MFC Listviews" (WDJ, May 
1996). I'm betting that, like the listview 
control, the treeview control pops up an 
edit control that uses the control ID of 
IDOK. I'll further bet that you have a 
WM_C0MMAND handler in your dialog proce¬ 
dure like this: 
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if(Control Id==IDOK) 

{ 

EndDialog(Dialog, Control Id); 
return TRUE; 

} 

Thus, when the edit control sends WM_COMMAND 
notifications, it seems like someone pressed 
your "OK" button. Try changing the relevant 
code to something like this: 

if(Control Id == IDOK && Code == 
BN.CLICKED) 

C 

EndDialog(Dialog, Control Id) ; 
return TRUE; 

} 

and that should fix the problem. —rib 


Subject: C++ Bug of the Month Column 
Hi Mark, 

I was reading your column in the 
May 1996 issue of Windows Developer's 
Journal and you mentioned that you 
would no longer be accepting bugs for 
the Visual C++ 4.0 16-bit compiler (aka 
1.52) because it looks like Microsoft 
won't be fixing any of these bugs. 

I believe that this is unfair to devoted 
readers of your column. Many VC++ 
developers rely on the 1.52 compiler for 
their 16-bit work, and just knowing 
about a bug — even if Microsoft doesn't 
fix it — is a definite time savings. I think 
it is imperative that you include bugs on 
any tool that ships in a current package 
from any vendor, because it speaks to 


the vendor's quality and responsiveness 
to customer issues. Please don't make it 
easier for Microsoft to drop support for 
the most predominate operating system 
in use today (and most likely for the rest 
of 1996). 

We go to great pains to support our 
developers' needs and we believe that if 
you do as you suggest in your article, 
developers will ultimately suffer. Put 
bluntly, Borland's goal is to meet devel¬ 
opers' needs, rather than to drop widely 
used operating system standards in 
order to promote new ones. 

Thanks, 

Jerry Shockley 
Senior Product Marketing Manager 
for Borland C++ 



Marketplace™ 




The best high 
performance, 
portable 
compression 
libraries for 
DOS, Windows, 
OS/2, Unix, 
Macintosh, 
embedded systems, 
and practically anything 
else, period. 


FREE DEMO 

DOS $249 
Winl 6 $299 

Win32 $299 
OS/2 $349 
Unix $349 
Macintosh $299 

DC Micro 
mSi Development 


45-function API 
Buffer compression 
File compression 
Disk spanning 
Encryption 
Self-extracting EXE's 
VBX/OCX controls 
On-line help 
Full source code 

Tel 606-268-1559 
Fax 606-266-0726 


Call 1-800-775-1073 

info@dcmicro.com http://www.dcmicro.com 
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Spy on any Windows Program! 


API Vision 



Total detail display for 2000+ APIs in 36 
categories, including base APIs, drivers, 
multimedia, networking, OLE, winsock, 
undoes and more. 


“Insanely Great” 

Software Development Magazine 


$199 


$8 ship. 


MasterCard, Visa 
30 day money-back guarantee 


Berkeley Toolworks 

800-593-5103 510-649-9891 apivis@berktool.com 
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Report woes? 

Slow, large, impossible? 


PrintForm 

Create complex, impossible reports. 

High quality documents, very well suited 
for form letters, reports and tables. Icons, 
bitmaps, texts. Fonts, word-wrapping, ali¬ 
gnment, headers, footers, numbering. DLL 
and C++ API. Demos in CompuServe: 
MSMFC or MSB ASIC. 

DLL and source versions, 16- and 32-bit. 
30 day money-back guarantee. 

Cobasoft GmbH: CIS: 100010,204, Tel: 449-531-72982 

Fax: +49-531-74501, pfo@kwgsoft.s-link.de 
European Software Connection: 800-986-6578, 913- 
832-2070, Fax: 913 832-8787, CIS: 71141,3624 
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STOP WASTING TIME 
CREATING LIST BOXES! 

ListBox Calculator™ 

ListBox Calculator™ eliminates the tedious 
guesswork of setting up list boxes, combo 
boxes, and column headings. Easy to use for 
beginning through advanced programmers. 
ListBox Calculator automatically determines 

• List/combo box width 

• List/combo box tab stops 

• Column heading sizes and positions 

For all languages and most popular fonts 

$49 

Visa, MasterCard 

Sheet Bend Software 

4061 E. Castro Valley Blvd., #197 
Castro Valley, CA 94552 

Phone: 510 581-2671 Fax: 510 581-8350 
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The Revolutionary Guide To 
MFC 4 Using Visual C+ + 


Mike Blaszczak 

ISBN 1-874416-02-3 
$49.95 

800 Pages + CD 



, Written by one of 
Microsoft's leading 
MFC developers 
. Updated for 
Visual C++ 4.0 and MFC 4.0 

Explains the use of threads, exception handling 
and more 

Covers Windows NT 3.51 and Windows 95 

For more details visit Wrox Press Developer's 
Reference on the web at: 

http://www.wrox.com 


How To Order 

Phone.800-937-5557 Fax.800-PRI-ORDER 

Visa MC Amex DS Quote code CL58 for free freight 
For more information or a free color catalog of 
Wrox titles please call 800-USE-WROX 
or 312-465-3559. 
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NuGraf® Developer's 3D Toolkit 

NuGraf is a complete drop-in solution for de¬ 
velopers seeking to integrate advanced 3D ren¬ 
dering technology into a new or existing CAD, 
modeling or visualization application. 

Features a mature, robust 
and proven photo-realis¬ 
tic Tenderer of impeccable 
quality and speed, a hier¬ 
archical database man¬ 
ager, a wide selection of 
3D modeling primitives 
(mesh, patch, NURBs), a 
hierarchical picking 
mechanism and a programmable output driver 
subsystem. Multi-platform: PC (DOS, Windows 
3.1/95/NT, Watcom) & UNIX. See WEB site for 
information, online API, demos and image gal¬ 
lery. $995 and $3500. M/C, VISA. 


Okino 6271 Dorman Road, Unit#6 
Computer Mississauga, Ontario, L4V 1H1 

Graphics, Inc. T: < 905 > 672 - 9328 , r 672-2706 

Email: sales@okino.com, WEB: http://www.okino.com 
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f Employment Service 



mall/fax/email resume J 
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g Lexi cus Longha nd 

Handwriting Recognition Software 


Software Development Toolkit 

Use our new SDK for high user acceptance 
of your pen applications. Lexicus Longhand 
provides a fast and natural method of data 
input. With our SDK, the creation and 
prototyping of your pen-based applications 
has never been easier. The SDK includes: 

- Dictionary Building Tools 

- Custom VBX Controls 

- Documentation 

- Code Samples 

1-800-LEXICUS 

415-462-6800 

http://www.lexicus.mot.com 


(ff) MOTOROLA 

Lexicus Division 
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Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&Djobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
and real-time, compilers, etc. Managed by 
graduate engineers. Send resumd or call for a 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.scientific.com 

CompuServe:? 1250,3001 AOL:davesroall 
SPI8, Box 19949, Houston, TX 77224 
713-496-6100 Fax:713-496-0373 
SPI8. Box 71, San Ramon, CA 94583 
510-733-6168 Beth@sptca.bdtcoro 
SPI8, P. O. Box 202676, Austin. TX 78720-2676 
512-260-0123 lej@zilker.net 


El 
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Opt-Tech Sort/Merge 


^ New-Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
Win95, OS/2, UNIX $249 
Call to order or for free info. 


Opt-Tech Data Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 

. (702) 588-3737 j 
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•WinEdit 96- 


Edit huge text files. Automate weird 
compilers. $99.95 WinEdit comes with 
software for Windows 3.1,95 and NT on 
Intel, Mips, Alpha, and PowerPC. Get all 
the usual editor features, plus a 
massive, 447-function macro language 
for the ultimate in configurability. 


See for yourself. Download a free, 100% 
functional, evaluation copy, now. 


• For your full, free, eiral copy: 

Web: http://www.windowware.com 
FTP: ftp.windowware.com in /wwwftp/wilson 
CompuServe: WINAPA, Sec. 15 
BBS: 206-935-5198 

r n 


Orders: 1-800-9384599 
or from our secure Web server 
Wilson WindowWare. inc. 
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SLSOOPE 


SLSC0PE is a comprehensive serial 
analyzer that enables you to examine, 
and interact with the data on any 
serial line in real time from your PC! 


■ Capture and Analyze at Baud Rates 
up to 115K. 

■ Selectable Formats Including 
ASCII and EBCDIC 

■ Fattern and Signal Searching 

■ Microsecond Timestamp Accuracy 

■ Manual and Cable Included 

■ 30 Day Money Back Guarantee 


"Easy to use and a great tool!" 

■ M. Hicks. Clement Industries. 
"Much easier to use than my old Analyzei 

■ J. Rhoads. Rhoads Systems Inc. 


Software Innovations Inc. -i 

(914) 567-0805 




“A 


63 Rock Cut Rd. Newburgh, NY CompuServe: 75013,3310 
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Windows NT Drivers 


Development 

Consulting 

Training 

by the best in the industry 


> File Systems 

> NDIS Drivers 


• Kernel Mode Drivers 

• Systems Internals 



Open Systems Resources, Inc. 

105 Route 101 A, Suite 19 

Amherst, NH 03031 

(603) 595-6500 — info@osr.com 


Call or email for a free no obligation quarterly subscription to 
The NT Insider , the world’s only newsletter dedicated entirely 
to Windows NT systems software development! 
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CDROMs! 


Official Slackware-- Linux - Slackware 3.0 (ELF) Linux, by author of 
Slackware. Easy install: learn Unix. XFree86 3.1.2, Td/Tk, GCC 
(2.7.0) compiler, Doom™. Works on 98% of PC's. 2 discs. $39.95 
Slackware subscription - convenient 3 month updates. $24.95 
FreeBSD® 2.1 - Berkeley BSD for PC. Solid Unix®-like, sre, XFree86 
3.1.1, dev. tools, etc. (Subscription every 6 mo. $24.95) $39.95 
CUG Library - 10 years C/C++ Users'Journal sre, listings. $49.95 
CICA® MS Windows - 5000 up-to-date shareware. 2 CDs. S29.95' 
Hobbes OS/2 Archived - 1000MB OS/2 apps, drivers. $29.95' 
Blackhawk 95 - 200 MB great Windows 95 applications. 529.95' 
Newt for NT - Windows NT app's, sre, utils, GNU, drivers. 539.95' 
Simtel® MSD0S - Two disc set, classic MSD0S shareware. 529.95' 
Science Library - Technical, engineering shareware + book. $39.95' 
Perl - Source, binaries for many systems, documents. $39.95 
Math Solutions - Math programs, source code, docs. $39.95' 
POV-Ray - 3-D Raytracing: 1000 wow! images, sre/binaries. $39.95 

‘Shareware programs require separate payment to authors if found useful 

— Authors wanted. Please email discdev@cdrom.com — 


ORDER NOW! 1-800-786-9907 


Shipping is $5 in USA/Canada/Mexico, $9 Overseas per order 





Suite D-693, 4041 Pike Lane, Concord CA 94520 
Phone: +1-510-674-0783 • FAX: +1-510-674-0821 • email:orders@cdrom.com 


All of our CDROMs are 100% unconditionally guaranteed! 

Call today for your free catalog of all our CDROM titles! i-i 

See these products free at http://www.cdrom.com/ Adcode: 693 


o Request Reader Service #187 a 


Windows Developer’s Journal — Page 77 


July 1996 


















































Unfortunately, when we're only doing 
one bug per month, we must focus that very 
limited space on what's relevant to the 
largest percentage of our readers. That's 
why, for example, we target only two ven¬ 
dors there — we know that over 90 percent 
of our readers make use of either Borland 
C++ or Microsoft C++. 

Our most recent reader survey 
(November 1995) showed that Visual C++ 
programmers were about half as likely as 
other programmers to be programming for 
16-bit Windows. I believe that trend has 
probably continued, which is one reason 
we've dropped coverage of that compiler. 
Certainly, WDJ has been clear about the 
fact that anyone doing serious 16-bit 
Windows development needs to get a non- 


Microsoft compiler at this point. Not all 
programmers in that situation have the 
freedom to switch, but 1 don't think the lack 
ofl.5x bug coverage in WDJ is going to be 
a significant part of their suffering. We'll be 
conducting another survey soon that will 
include readers we've acquired since our 
most recent circulation jump, and if that 
shows I'm wrong about the degree to which 
Visual C++ vl.5x has become marginal¬ 
ized, maybe we would perhaps reconsider 
our position. 

The other reason we're dropping Visual 
C++ vl.5x coverage is because none of 
those no bugs will be fixed. Although it's 
useful to know bugs exist, I feel that half the 
importance of the Bug++ column is that 
bugs actually get fixed. A common com¬ 


plaint from readers (both Borland and 
Microsoft customers) is that their attempts 
to report a particular bug or get it fixed 
were ineffectual; then, after the bug 
appeared in Mark's column the bug was 
fixed. I rate that an important aspect of the 
column, ivhich is another reason that VC 
1.5x bugs no longer pass the size/benefit 
ratio test — each 1.5x bug takes up space 
that could have been used by a 4.x bug that 
Microsoft might fix (at least for those cus¬ 
tomers who pay the extra money required to 
receive interim Microsoft compiler bug 
fixes). 

Finally, some bugs in Visual C++ 4.x 
(ivhich we now actively cover) date all the 
way back to 1.5x, ivhich means we will still 
sometimes effectively cover Visual C++ 



Developer's 

Marketplace™ 


Add ZIP (and UNZIP too!) to 
your Windows applications! 


DynaZIP 3 0 

Data Compression Toolkits 

The new ROYALTY-FREE DynaZIP family of 
developer's tools let you add ZIP and 
UNZIP capabilities to your Windows 
applications. No more "shelling" to 
DOS, no more fussing with proprietary 
compression formats. DLLs, VBXs, OCXs 
and a new database interface provide 
full access from many languages. Fast, 
reliable, and easy to use! 16 and 32 
bit versions, supports long filenames. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: (800) 962-2949 


Inner Media. Inc.. Hollis NH USA (603) 465-3216. tax (603) 465-7195 
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Demo / Tutorial / CBT / Presentation 


Visual Windows Automation 
Multimedia Authoring Development Kit 

D Use Show Basic Recorder to generate the editable, 
mouse/keyboard simulation code invariant to window 's 
size and position, screen resolution and video driver. 

□ Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

□ Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP. WMF. WAV, MIDI. AVI), compatible with 
Windows 3.1. Windows 95 and Windows NT . 

□ deliver your titles transparently via WWW - 
ShowBasic can be integrated with any WEB browser. 

Development licence S29*> with .Ml day money back guarantee. Royalty live licence Wft 

If you don’t need all the power of ShowBasic - use our simple, 
yet flexible scripting language for live demos and automation: 

SSTTlDHELR«IO 4TP TT - 

Single-user license VVItViO Pro). Royally tree license SJ<IO<SS<XI Pml. Visa/MC accepted 

Find more information, demos, samples and evaluation copy: 

http://www.cnj.digex.net/~mik 

■ MIKSoft, Inc. tel/fax: 908-390-8986 

37 Landsdownc Road. Fast Brunswick NJ. OKS 16 
Internet: mik@cnj.digex.net CompuServe: 74127.3671 
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0 Design Tool 
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• Customize Code Generation for State 
Diagrams in almost any Language - Ada, 
VHDL, C, Delphi, Pascal, Smalltalk,more 

• Standard Scripts available for C, 
VHDL, C++, Pascal; Custom Reports 

• Template driven code for State, Class 
and Object Interaction Diagrams 

• Reverse Engineer C++, Delphi code 
32, 16 bit WITH CLASS starts at $295 
Call for FREE Eval: 908.668.4779 


MICROGOLD SOFTWARE. INC. 

76 Linda Lane Edison, NJ 08820 
www.microgold.com 
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C and C++ DOCUMENTATION 


!! VERSION 6.0 !! 

• C-CflLL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-DOC ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BR0WSE Windows graphic-tree viewer. 

• C-DOC Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way. Mississauga Voice/Fax (905) 858-4466 
0NT Canada L5N-4M1 http://swbs.idirect.com 


Please see Ad Index for our larger ad. 
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* Dazzle/VB - image manipulation. $199 

* VBIite - print/comm/array/B-Tree index.. $149 

* ProMath/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 

* QuickLine/VB - telephony (multi-line) ...$495 

* SpellCheck/VB spelling S lookup. $49 

* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming .. .$80/h 


Develop your VB app faster: Get TeraTech 
tools! Call, E-mail or fax us and well mail you a 
free demo disk ASAP. Or for faster service 
downlo ad bv FTP or from our BBS. Call now! 

800-447-9120 ext. 1203 

Dept. 1203, 100 Park Avenue, Suile 360, Rockville, MD 20850 USA 
Int i: +1-301-424-3903 Fax: (301) 762-8185 BBS: (301) 762-8184 

Copyright TeraTech 1995 Al rights reserved. Trademarks are the property of their holders. 
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vl.5x without either of the disadvantages 
I've just mentioned. 

I agree with you that it's a service to con¬ 
tinue to report the bugs in Visual C++ vl.5x 
(as it would be to include regular bug cover¬ 
age of other compilers that have less market 
share), but it comes down to the need to 
serve the most readers with the limited space 
we have. — rib 


Subject: MFC Coverage 

I recently renewed my subscription 
to WDJ because of its fantastic coverage 
of MFC and C++. I hope you continue to 
focus on C++ (Microsoft VC, Borland, 
Symantec) developers and run as many 
articles as possible on MFC. The most 
recent issue seemed to become slightly 


watered down in a visual programming 
perspective (i.e., covering Delphi, VB, 
etc.). I have seen the visual craze 
(+RAD) in many of my magazines slow¬ 
ly push C++ issues to the side and move 
VB to the forefront. Please do not let this 
happen to your magazine. Keep up the 
great C++ and MFC (my personal inter¬ 
est) work in your magazine. 

Thanks, 

Andrew Vogel 

Our core focus continues to be the 
Windows API, which is relevant to almost 
all experienced Windows programmers, no 
matter ivhat their favorite toolset. MFC 
isn't our main focus, but it will continue to 
appear regularly. You might be interested 


in some of the upcoming compiler bench¬ 
marks that will reveal performance impli¬ 
cations for any code that makes extensive 
use of object-oriented programming (like 
MFC programs). Also, once a year we have 
an MFC theme issue that is guaranteed to 
have a couple of articles that focus on MFC 
topics. The next one will probably roll 
around in January. Finally, since V. 
Ramachandran has started editing our 
SDK annotations, we've started including 
a certain number of MFC annotations, so 
keep an eye out for those. Thanks for the 
feedback! — rib 
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COMPRESSION LIBRARY 



NDIS • VxD • VDD 

1 


FOR VISUAL BASIC AND DELPHI 


Finally, a compression component that 
gives you your money's worth! Add 
Xceed Zip to your project, set a few 
properties, and your apps will be ziping 
and unziping in minutes. Great for 
automating backups, preparing files 
for transmission, or developing your 
own custom installer. 



( 800 ) 865-2626 
( 514 ) 442-2626 


Visit www.xceedsoft.com for a 
free trial version and find out 
why Xceed Zip is rapidly becoming 
the most popular VB and Delphi 
compression library! 


Port your Windows 3.x drivers to 
Windows 95 and NT. 

We have over 4 yrs experience in 
developing Device drivers for 

• Barcode Scanners 

• Network Cards 

• IRDA Devices 

• Serial Communications 

Infosolv Inc. 

(800) 775-7658 
info@infosolv.com 


Visit us at http://wwu.infosolv.eom 
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Basic Scripting 


Cypress Enable 3.0 
Basic Scripting for Applications 

A powerful, complete, royalty free, VBA 
compatible, embeddable Basic Scripting 
Language. Cypress Enable Features: Royalty - 
free licensing, 60 day money back guarantee, 
OLE 2.0 Automation, Direct access to C++ 
objects, Dynamic Dialogs, Dialog Editor, 
Debugger (w/source). Named parameters. 
Easily extended. Printed & on-line 
Redistributable end-user documentation, Small 
footprint engine < 200K, Free tech support. 16 
bit $495; Mac, UNIX, DOS, Win 3.1, NT & 95. 
For whitepaper call: 1-800-790-4050. 



email cypress@cypressinc.com 
Fax:(602) 951-8047 www.cypressinc.com 
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•fk Cash in on 
g the Voice 
— Bonanza! 

Get your piece of the $3 billion Voice Industry - 
develop your own Computer Telephony Apps! 

Add voice power Audio Tool Box* Call and ask about 
to your Windows lets you batch our VFEdif 
apps with TI/F process and professional voice 

DLL ” (CT Mag's convert audio files prompt editor. 
Product of the to & horn standard Scribe " trans- 
Year), our popular formats. Adjust cription utility, 
interface to volume, filter, trim y ox f onts " text _ 

Dialogic™ multi- silence, more! Add t0 _ speech library, 
line telephony l ° y°" a PP* with p , us more great 

hardware. ToolBox SDK. products! 


f/s/ 800-469-4874 


VISI, 2118 Wilshire Blvd, #973, Santa Monica, CA 90403 
310-392-8780 Fax: 800-234-FXIT / 310-392-5511 sales@vinfo.com 
BBS: 310-392-6610 www.vinfo.com (Download Working Demos) 
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The Fastest xBASE Engine... 

for C, C++, Visual Basic and Delphi 
database application programmers! 

With CodeBase 6.0, you get: 

• Multi-user compatibility with 
FoxPro, Clipper and dBASE files. 

• Portability between Windows, 

Win95, NT, DOS and UNIX. 

• Support for the popular C/C++ 
compilers, Visual Basic and Delphi. 

• Data aware controls for Windows. 

• Powerful visual report writer. 

• Client/Server option. 

• Royalty Free distribution. 

FREE 30 day trial 

Call Sequiter Software Inc. for details! 
Phone: 403 437 2410 FAX: 403 436 2999 
Internet: sequiter@supemet.ab.ca 
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The Weekly MFC Extension 

0 The only MFC extension class library that 
delivers new class(es) every week 
0 Updated through eMail 

0 Includes all classes available upon subscription 
0 Free sample classes available as demo 
0 Only $150 annual subscription 

Oeto+ Dataview 

The Dataview client OCX and OLE server turn 
any ODBC compliant database into an advanced 
Client/Server environment. The OCX displays 
data through a user friendly grid. The 32bit 
multithreaded OLE automation server services 
remote OLE requests through high level objects. 
Includes SQL wizard that generates advanced 
dataviews (for local and remote databases) in 
minutes without requiring SQL knowledge. 


Only $299 


Contact 

eMail: info@periphere.com 1 


http://www.periphere.com 1 
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Win-Emacs 

The Complete Emacs Text Editor 
for Microsoft Windows® 


NEW! 32-bit version 
for NT/Win95/Win 3.1 


Win-Emacs™ is a full implementation 
of XEmacs 19.6—including e-lisp 
interpreter—for just $199 

To Order Call 1 -800-WIN-EMACS 


Pearl Software Corporation 

Tel: 510-652-4361 • Fax: 510-652-4362 
http://www.pearlsoft.com/ _ 
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Port I/O on NT/95 


WinStar Hardware Classes 2 

it 

Hardware access library for Win32 
and VB4 applications. 

* C routines, C++ classes, and OCX 

♦ Port and physical memory access 

♦ Interrupt service routines 

« Supports both Wndows 95 and NT 

* No DDK development required 

Other WinStar products... 

o Device Talk NT driver debugger 
o Kernel BASIC cross-platform driver 
development environment 

WinStar Technologies. 

(415) 647-2815 

74367.1773@compuserve.com 


visit us at http://www.wintech com 
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Web Page: http://www.bluewatersystems.com 

HASSLE FREE HARDWARE CONTROL 

IVersion 2.01 



New Features: 
•Script 
Language 
■if-else 
-while! I 
■Arrays 
•Faster 
Execution! 
-Avg. 15% 


Windows95 , , , 

Binary Compatible 

Spend your time writing your App...not 
wading through D.D.K. documentation! 
Fast hardware control under Win32® 
without the device driver kit! 

V Port I/O V Memory I/O V Interupts 
OCX version also available 
Ask us about Alpha™, PowerPC™ & MIPS versions 
NO RUNTIME ROYALTIES 

VISA, MC, AMEX & Approved P.O. accepted 
Tel (206)771-3610 • fax (206)771-2742 
E-Mail: info@bluewatersystems.com 

(800)962-2114 
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PR-Tracker 


Problem Report Tracking for Windows 


By Soft wise phone: 206-513-0415 
softwise@halcyon.com 
http://www.halcyon.com/softwise/prtracker.html 



Helps manage software 
development projects by 
tracking software bugs. 
Records problem 
reports in a network 
database that supports 
simutaneous access by 
multiple users. 

Features classification, 
assignment, sorting, searching, 
and estimation. 


* Supports project by project data 
entry and workflow configuration. 

Download PR-Tracker for evaluation 

ftp://ftp.halcyon.com/local/softwise/prtrack.zip 
CompuServe: Case Forum: prtrack.zip 



NEW V5.1 for Win 3.1, NT, DOS & OS/2 

Western Wares 

Free Demo(303) 327-4898 
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PROGRAMMERS... 

$100k/yr at HOME! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS ... Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


CALL 800-364-4883 


Call TODAY for a FREE special report! 
ULTRA _ Fax: 214-724-0375 

Financial Systems CompuServe: 71223,634 

1633 Arrowhead Dr, Flower Mound, TX 75028 
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www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-1. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


Data processing 
I NDEPENDENT 
Consultant's fj 
E XCHANGE . 


A Service of D&L Online, Inc:. (515) 280-1144 
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Call 800 - 645-3729 now for your 
free catalog about Sax Comm 
Objects, Sax Setup Wizard, Sax 
Webster Control, and Sax Basic 
Engine. 

http://www.saxsoft.com 


Phone: (541) 344-2235 
Fax: (541) 344-2459 
email: info@saxsoft.com 
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Dr. DeeBee 
ODBC Tools 

Tools for ODBC development 



Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 


□r. DeeBee ODBC Driver Kit 


Connect proprietary databases to 
Access, Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 



-&WJ'REZ - 

RO. Box 91 Kendall, Cambridge, MA 02142 
617-497-1376 Fax 617-497-8729 
http://www.syware.com 
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HIGH PERFORMANCE 
^ CONVERSION 
SCALE-TO-GRAY 
IMAGE PROCESSING 
THUMBNAILS 


PRINTING 
SCANNING 
FAST DISPLAY 
COMPRESSION 
and more! 


The Best Imaging Toolkit - Is Now Even Better! 


AccuSoft Corporation announces a totally new product, 
ImageGear,” the next generation in imaging technology. 
ImageGear, the new version of the AccuSoft Image 
Format Library”, is more than just an upgrade, it is a 
whole new level of the quality and 
performance that has made AccuSoft the 
leading supplier of imaging toolkits. Just 
for starters, we redesigned all the image 
filters to add several new features to 
ensure that our support for image 
formats is by far the most comprehensive. We even 
added file-info executables for every format we 
support - and, of course, we added several new 
formats. 

ImageGear has a new and improved API that makes 
integration even easier, plus many new features 


including totally redesigned display functions for faster 
image display, sub-pixel accuracy, transparency, and an 
automatic image window with many built-in features. 
We also added new GUI functions including a 
comprehensive thumbnail browser, pan and 
zoom windows, magnifying glass, page 
sorter and more. All with complete 
programmability. We completely 
revamped the image processing to add 
dozens of new functions and better 
performance. In addition, we have improved the 
scanning, image compression, display effects, and just 
about everything else! 

So get into high gear with ImageGear and remember - 
the best imaging toolkit makes the best applications - 

ImageGear 6.0! 



You can start using 
I AccuSoft products 
today by taking 

AA ikii irr advantage of our 
r\INU I C- unique 30 Minute 


Toll Free: (800) 525-3577 
Website: accusoft.com 


AccuSoft 

High Performance Imaging 


Two Westborough Business Park Weslborough, NA 01581 Tel (508) 898-2770 FAX (508) 898-9662 

©1996 AccuSofl Corporation. All Rights Reserved. All company and brand names are trademarks or registered trademarks of their respective owners. 1 Raster only 2. License required from Unisys for formats using LZW compression. 3. Optional 


Windows 
Win95\NT 
MIPS NT 
Alpha NT 
VBX 
OCX 
OS/2 
SUN OS 
Solaris 
HP-UX 
RS/6000 
SGI 
SCO 
MAC 

PowerMac 

Over 45 File 
Formats 

JPEG 
TIFF 
Group III 
Group IV 
PCX 
TGA 
PGM 
DIB 
IMT 
DCX 
BMP 
KFX 
RLE 
LV 

CALS 
ATT 
CLP 
XWD 
XBM 
CIF 
IFF 
SUN 
PNM 
I0CA 
GX2 
XPM 
ASCII 
CUT 
GEM 
BRK 
MAC 
PSD 
MSP 
PNG 
PCD 
IMG 
IGF 
SGI 
ICO 
PBM 
PPM 
M0:DCA 
WMF 1 
WPG 1 
PICT 1 
EPS 1 
GIF 2 
ABIC 3 
JBIG 3 
DICOM 3 
and others 


i 
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Announcing BoundsChecker 4.0 

Because There's More To Windows Error Detection 
Than Finding Memory Errors 



Time For A Change ... Use BoundsChecker 4.0 

Today's error detection challenges go far beyond C/C++ 
memory corruption and leaks to include much larger prob¬ 
lems. Interfaces and software layers are growing at a 
faster pace than most developers can keep up with. Tools, 
libraries, and components are isolating the developer from 
the actual interface with wrappers. And, many of the most 
costly bugs are interface-related and often several layers 
away from the source code. You need one tool that does 
the whole job. You need BoundsChecker! 


"Smart Debugging"™ For Visual C++ Users 
Along with power and visibility, BoundsChecker 4.0 
achieves new levels of ease of use. BoundsChecker is now 
seamlessly integrated into the Microsoft Visual C++™ debug¬ 
ger. Because it is fully hosted by the IDE you can view your 
errors and immediately go to the offending source code. 
Every time you debug, BoundsChecker is transparently 
working to find additional hidden, costly bugs. By finding 
these bugs earlier in the process you will release higher 
quality software sooner. 


Here's Why: 

NuMega's BoundsChecker solves many of the complex 
interface-related problems that Windows developers are 
likely to encounter. If you are building COM-based 
software or using the Microsoft® Internet interfaces and 
APIs, BoundsChecker 4.0 is invaluable. It intercepts control 
and validates interfaces in thousands of strategic places, 
automatically pin-pointing errors. The event window then 
shows a step-by-step, layer-by-layer history of events that 
gives a clear picture of what software components were 
responsible. Because C/C++ memory bugs and leaks can 
still appear, BoundsChecker Professional Edition includes 
CTI™, the most advanced memory and leak detection 
technology available. No other debugging tool offers so 
much power and visibility. 

9 Townsend West • Nashua, NH 03063 • 603.889.2386 

info@numega.com 


New In BoundsChecker 4.0 

Parameter validation and logging of OLE interfaces 
Parameter validation and logging of Microsoft Internet 
interfaces and APIs 

User-extensible API validation (Validate your own APIs) 
"Smart Debugging" with the Visual C++ debugger 
(Evaluates each line of code for errors as you debug) 
Supports Borland Delphi® applications 

Call 1 -800-4-NUMEGA to order! 
Contact our web site to learn more about the 
exciting new features of BoundsChecker 4.0 
http://www.numega.com/bc4.html 


Fax 603.889.1 135 
http://www.numega.com/ 

NuMega Technologies, the NuMega logo, SoftICE, and the SoftICE logo are trademarks of NuMega Technologies. 
All other trademarks are the property of their respective manufacturers. Copyright ©1996. All rights reserved. 
Compile Time Instrumentation (SCI) and Runtime Pointer Tracking (RPT) technology provided by pgf M ParaSoft™ Corporation. 


NuMega 
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